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Preface 
This manual tells you: 


® How to attach the IBM Personal Computer System Unit to the 
IBM 3278 Display Station or to the 3279 Color Display Station 


© How to operate the display station as a personal computer 
© How to use the display station as a programmable terminal 
© How to do screen capture and file transfer 


@ How to do problem determination and isolate the defective 
device (the system unit or the display). 


This manual does not tell you how to operate a personal computer; 
refer to the IBM Personal Computer manuals listed under “Other 
Manuals to Read.” 


Who Should Use This Manual 

_ This manual is for any 3278 or 3279 user who has the IBM Personal 
Computer System Unit attached to the 3278 or 3279 display. This 
manual assumes that you are familiar with: 
e General concepts, such as how to log on to the host application 
@ The 3278/3279 keyboard 
e The IBM Personal Computer manuals, including the JBM Personal 

Computer Disk Operating System (DOS 1.1 or 2.0). Refer to the 


respective DOS manual for an explanation of the DOS 1.1 or 2.0 
commands and concepts used in this manual. 
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What Is in This Manual 


This manual has six chapters and 10 appendixes: 


Chapter 1, Introduction, gives an overview of the IBM 3270 Personal 
Computer Attachment. 


Chapter 2, Setup and Option Installation, contains instructions for 
preparing, placing, cabling, powering-up, and checking out the IBM 
3270 Personal Computer Attachment. Use this chapter when setting 
up your IBM 3270 Personal Computer Attachment. _ 


Chapter 3, Customization, tells you how to prepare your IBM 3270 
Personal Computer Attachment DOS diskette and how to select your 
keyboard reference card. Read this chapter before trying to operate 
your display station as an IBM Personal Computer. 


Chapter 4, How to Operate and Use the Keyboard, explains the 
operating sequence and how to use the 3278/3279 keyboard in 
personal computer mode. It tells how to switch modes and gives some 
commonly used personal computer key sequences. This chapter also 
shows you how to use the XLATKBD program to change the personal 
computer key function mapping on your 3278/3279 keyboard. 


Chapter 5, Data Transfer, explains how to capture screens and to 
transfer files between the personal computer and the host with the 
sample application programs supplied. 


Chapter 6, Problem Determination, tells you how to isolate and 
correct problems that occur during setup and during operation of the 
IBM 3270 Personal Computer Attachment. Read this chapter when 
your system does not work properly. 


Appendix A, Assembler Application Program Interface, defines the 
functions that a personal computer application program can use to 
pass data between the personal computer application program and the 
IBM Personal Computer 3270 Attachment Option. 


Appendix B, BASIC Application Program Interface, describes con- 
cepts similar to Appendix A for beginner’s all-purpose symbolic 


instruction code (BASIC). 


Appendix C, PASCAL Application Program Interface, describes con- 
cepts similar to Appendix A for PASCAL. 
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Appendix D, IBM Personal Computer 3270 Attachment Option, gives 
technical reference information about the IBM Personal Computer 
3270 Adapter. 


Appendix E, Setup for Data Transfer, guides supervisors or system 
programmers in setting up the personal computer, host, and control 
unit for screen capture and file transfer. 


Appendix F, Data Transfer Formats and Translation Tables, provides 
data formats and translations for the supplied data transfer sample 
application programs. 3 

Appendix G, File Transfer Data Streams and Error Messages, gives the 
structures for transferring data between the host and the personal 
computer. This appendix contains descriptions for “impossible”’ 

file transfer error messages. 

Appendix H, Advanced Diagnostics, should be used as an addendum 
to the JBM Personal Computer Hardware and Service and IBM Personal 
Computer XT Hardware and Service manuals. It is assumed that users 
of this appendix have hardware service experience. 

Appendix I, Parts List, gives the part numbers for the cables, distri- 
bution box, and adapters used by the IBM Personal Computer 3270 
Attachment Option. 


Appendix J, Repack Instructions, contains instructions on how to 
repack your system unit when relocating it or returning it for repair. 


Keyboard Reference Cards, at the back of the manual, fold out for 


quick key reference when you are working in personal computer 
mode. 


Other Manuals to Read 

IBM Personal Computer Library 
These personal computer manuals will be useful for reference: 
@ Guide to Operations, Part Number 6025003 


e BASIC, Part Number 6025010 
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e Disk Operating System, Part Number 6024001 
@ Technical Reference, Part Number 6025008. 


CMS and TSO Manuals 


Conversational monitor system (CMS) and time sharing option (TSO) 
manuals are listed in: 


e IBM System/370 and 4300 Processors Bibliography, GC20-0111. 


IBM 3270 Information Display System Library 


Some IBM 3270 Information Display System manuals you might also 
use are: 


e IBM 3274 Control Unit Description and Programmer's Guide, 
GA23-0061 


@ IBM 3274 Control Unit Planning, Setup, and Customizing 
Guide, GA27-2827 


e IBM 3274 Control Unit Customizing Guide, GA23-0065 


e IBM 3270 Information Display System Data Stream Program- 
mer’s Reference, GA23-0059. 
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Summary of Changes 
If you have used this manual before, you will want to know the 
changes to the IBM 3270 Personal Computer Attachment as well as 
the changes to this User's Guide. 


Changes to the IBM 3270 Personal Computer 
Attachment 


The IBM 3270 Personal Computer Attachment now supports: 

@ The IBM 3279 Color Display 

@ The IBM Personal Computer Disk Operating System, Release 2.0. 
The HOST command now supports: 

e@ The structured field TRACE 

e PATH. 

The PCXFER command now supports: 

e User-specified ASCII-to-EBCDIC translation 

e TCAM. 


The Interrupt Handler (3270ATT) now supports the attachment of 
personal computer monitors and generates a break for each keystroke. 


The customization program on the Customization diskette is simpler 
to use. 


A new diskette, the Attachment Option Enhancements diskette, is 
now part of the IBM 3270 Personal Computer Attachment. This 
diskette includes: 

@ The XLATKBD program for changing keyboard mappings 

e The BASIC version of the Application Program Interface 


e The PASCAL version of the Application Program Interface. 
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Changes to the User’s Guide 


Chapter 5, Data Transfer, is reorganized for improved usability. 
Some of the information from Chapter 5 is now in two new appen- 
dixes: 


Appendix E, Setup for Data Transfer 

Guides supervisors or system programmers in setting up the 
personal computer, host, and control unit for screen capture 
and file transfer. | 


Appendix F, Data Transfer Formats and Translation Tables 


Provides data formats and translations for the supplied data 


. transfer sample application programs. 


Appendix A, Assembler Application Program Interface, is reorganized 
for improved usability. 


Appendix B, BASIC Application Program Interface, and Appendix C, 
PASCAL Application Program Interface, have been added. 


As a result, the other appendixes have changed places: 


Appendix B, IBM Personal Computer 3278 Attachment Option, 
is now Appendix D. 


Appendix C, File Transfer Data Streams, is now Appendix G. 
Appendix E, Advanced Diagnostics, is now Appendix H. 
Appendix D, Parts List, is now Appendix I. 


Appendix F, Repack Instructions, is now Appendix J. 


File transfer error messages have been added in Appendix G, File 
Transfer Data Streams and Error Messages. 


xvi Summary of Changes 


Chapter 1. Introduction 


What Is the IBM 3270 Personal Computer 
Attachment? 


The IBM 3270 Personal Computer Attachment is a feature that allows 
an IBM Personal Computer System Unit (referred to as system unit 

in this manual) to be connected to an IBM 3278 Display Station 
(Figure 1-1) or to an IBM 3279 Color Display Station. 


Figure 1-1. 3278 Display Station with IBM 3270 Personal 
Computer Attachment and IBM Personal Computer 
System Unit 


With the IBM 3270 Personal Computer Attachment you can: 


e@ Use the 3278 or 3279 display and keyboard in place of the IBM 
Personal Computer Monitor and Keyboard 


e Use the IBM Personal Computer Disk Operating System (DOS) 
1.1 or 2.0 (referred to as DOS through the rest of this manual) 


e Use application programs that run with the IBM Personal Com- 
puter DOS 


e Run host and personal computer programs simultaneously 
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e Transfer data between the host system and the IBM Personal 
Computer printer, diskette, or fixed disk (the term disk refers 
both to the diskette and to the fixed disk for the rest of this 
manual) 


e Transfer files between the host system and the IBM Personal 
Computer printer or disk 


e Transfer selected host-generated screens to the IBM Personal 
Computer printer or disk 


e Use either the IBM Monochrome Display and Printer Adapter 
(for 3278 Models 1—4) or the IBM Color/Graphics Monitor 
Adapter (for all 3278 and 3279 models) 


e Use the IBM Personal Computer System Unit 


e Use the IBM Personal Computer with the Expansion Unit 5161 
(Models 1 and 2) 


e Use the IBM Personal Computer XT System Unit 5160. 


Modes of Operation 


The IBM 3270 Personal Computer Attachment allows you to operate 
with the host computer or with the system unit. These two modes of 
operation are called host computer mode and personal computer 
mode. You can operate in these modes with any IBM 3274 or 3276 
control unit or IBM Integrated Display Adapter (IDA). (For the rest 
of the manual, the term control unit refers to all three types: 3274, 
3276, and IDA.) 


Host computer and personal computer modes operate independently. 
The data transfer functions depend on the 3274 control unit micro- 


code. This microcode provides a communication path for host and 
personal computer sample data transfer applications. 
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Host Computer Mode 


When the system is in host computer mode, the control unit processes 
your input and sends it to the host. The system unit does not interfere 
with the processing. All your 3278 or 3279 functions operate as be- 
fore. It does not matter whether the system unit On/Off switch is set 
to On or Off. 


Personal Computer Mode 


When the system operates as an IBM Personal Computer (personal 
computer mode), the personal computer program running in the 
system unit processes your input. The results display on the 3278 or 
3279 display (referred to as display for the rest of this manual). 


In personal computer mode, the display station can use software 
available for the IBM Personal Computer that executes under control 
of the IBM Personal Computer DOS. You can run existing personal 
computer programs or develop new ones. In this mode, the 3278/ 
3279 keyboard (referred to as keyboard for the rest of this manual) 
is your input device, and the display is your monitor. The system unit 
is now processing all your input and requests. It does not matter 
whether the control unit or the host is on or off. 


A set of IBM Personal Computer manuals comes with your system 
unit. Take the time necessary to understand these manuals and the 
many functions and applications you can perform. For other IBM 

Personal Computer options available for your display station, refer 
to the IBM Personal Computer documentation. 


Considerations for the 3279 Color Display 


A 3279 Model 2A, 2B, 3A, or 3B requires a 3274 or 3276 control 
unit to carry out its color convergence. If your 3279 is not connected 
to an operating control unit, it will remain unconverged and no per- 
sonal computer mode picture will be displayed (the divider line will 
be green). In this case, a green personal computer mode picture may 
be seen by setting the front panel Normal/Test switch to Test. 


Once the 3279 has been converged, it will remain converged even if 
the control unit is disconnected or powered off. 
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If you were previously using a color monitor with your personal | 
computer, you will notice some differences between the color moni- 
tor display and the 3279 display: 


e Color 


The 3279 does not intensify colors. Light blue is displayed as 
blue, light green as green, and so on. Also, there may be some 
differences in shading between the 3279 and another color moni- 
tor. 


e Borders 


The 3279 does not show a top/bottom border color, and the left. 
and right borders are likely to be smaller than on other monitors. 


e Characters 


The ratio of character height to character width is different on 
the 3279 (the ratio of character width to height is 3 to 4, while a 
typical personal computer monitor is 5 to 6). In addition, charac- 
ters have a more noticeable striped effect (particularly on a 3279 
Model 2). 


Note that the 3279 has a Color Convergence Procedure to ensure that 
secondary colors are pure. See the Problem Determination Guide in 
your keyboard for the color convergence procedure. Do not leave the 
host computer mode display showing the convergence procedure 
when you switch to personal computer mode. Otherwise, you would 
prevent other users from using the convergence routine. 
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Data Transfer - 


The IBM 3270 Personal Computer Attachment also provides expand- 
ed programming capability by transferring data between the host 
applications and the personal computer applications. Two types of 
data transfer support are provided as sample applications: file transfer 
and screen capture. 


The file transfer function initiated in host computer mode allows you 
to send files that were processed in personal computer mode to the 
host for further processing or storage. Files can also be sent from the 
host to the system unit for processing or storage. The sample appli- 
cation programs provided transfer files in both of these directions. 
You can work in personal computer mode and then transfer these 
files to the host, or vice versa, at your convenience. 


You can use the screen capture sample application program to copy 
the contents of the host screen image to the IBM Personal Computer 


printer or disk. 


See Chapter 5 for information about how to capture screens and how 
to transfer files. 
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What Are the Prerequisites for the IBM 3270 
Personal Computer Attachment? 


The following are required for the IBM 3270 Personal Computer 
Attachment: 


1. An IBM Personal Computer 
Choose one from the list below: 


L) An IBM Personal Computer 5150 Model X14, X64, or X74 
with a Color/Graphics Monitor Adapter (any 3278 or 3279 
model) 


CL] An IBM Personal Computer 5150 Model X14, X64, or X74 
with a Monochrome Display and Parallel Printer Adapter 
(3278 Model 1, 2,3, or 4) 


CL] An IBM Personal Computer XT 5160 Model X87 with a 
Color/Graphics Monitor Adapter (any 3278 or 3279 model) 


L] An IBM Personal Computer XT 5160 Model X87 with a 
Monochrome Display and Parallel putes Adapter (3278 
Model 1, 2, 3, or 4) 


CL] An IBM Personal Computer System Unit with 

e A Color/Graphics Monitor Adapter (any 3278 or 3279 
model) or a Monochrome Display and Parallel Printer 
Adapter (3278 Model 1, 2, 3, or 4) 

e A5-1/4-inch Diskette Drive Adapter and one diskette 
drive 

e A 64K-byte memory (K equals 1024) for DOS 1.1 or 
a 128K-byte memory for DOS 2.0 


L] An IBM Personal Computer XT System Unit with 
e AColor/Graphics Monitor Adapter (any 3278 or 3279 
model) or a Monochrome Display and Parallel Printer 
Adapter (3278 Model 1, 2, 3, or 4) 


2. IBM Personal Computer DOS 
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3. 


An IBM Display Station (that includes one of the IBM 3278/3279 
keyboards defined by the layout diagrams in Chapter 3) 


Choose one from the list below: 


L] IBM 3278 Display Station (with no Magnetic Slot Reader, 
FC 4999) Model 1, 2,3, or 4 


CL] IBM 3278 Display Station (with no Magnetic Slot Reader, 
FC 4999) Model 5 (Color/Graphics Monitor Adapter Re- 
quired ) | 


C] IBM 3279 Color Display Station (with no Magnetic Slot 
Reader FC 4999, no Selector Pen FC 6350/51/60, and no 
Video Output FC 8750) Model 2A, 2B, S2A, 3A, 3B, S2B, 
S3G, 02X, or 03X (all the models require the Color/Graphics 
Monitor Adapter) 


Requirements for Screen Capture 


The following are required if you use screen capture: 


1. 


An IBM 3274 Control Unit with Configuration Support C, Re- 
lease 46 or higher; or with Configuration Support D, Release 
60 or higher 


A 128K-byte memory (minimum) in the IBM Personal Computer 
System Unit for sample application programs. 


Requirements for File Transfer 


The following are required if you use file transfer: 


is 


An IBM 3274 Control Unit with Configuration Support C, 
Release 46 or higher; or with Configuration Support D, Release 
60 or higher 


A 128K-byte memory (minimum) in the IBM Personal Computer 
System Unit for sample application programs. 
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3. Virtual Machine/System Product (VM/SP) 


If the IBM 3278 does not have an Extended Character Set Adap- 
ter (FC 3610 or FC 3620), or if the 3279 does not have the Ex- 
tended Function (FC 3850), then Service Level 206 (PUT 8305) 
must be installed on VM/SP. 


4. Time Sharing Option (TSO) with Advanced Communication 
Function/Virtual Telecommunications Access Method (ACF/ 
VTAM), Release 1.3 


Or 


TSO with Advanced Communication Function/Telecommunication 
Access Method (ACF/TCAM), Release 2.4 


e Program Temporary Fix (PTF) UZ90256, UZ90257, 
UZ90258 Authorized Program Analysis Report (APAR 
0OZ69872) 


e@ PTF UZ67877 (APAR 0Z73530) 
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Chapter 2. Setup and Option Installation 


Introduction 


This chapter contains all the information needed to complete setup 
of your IBM 3270 Personal Computer Attachment. It tells you: 


e@e What you need for setup 

e How to prepare your system unit for cabling it to the display 
e How to cable up your system unit to the display 

@ How to do the Power-On Self-Test. 


Follow the instructions in each procedure in sequence. A check 
box L] is provided at each step and at each action you must do. Put 
a check (v) in the box as you finish each action and each step. This 
helps you to keep track of which steps have been completed in the 
event you are interrupted during setup. 


Getting Ready 


In the shipment containing your IBM 3270 Personal Computer 
Attachment are two boxes, labeled as follows: 


e IBM 3270 PC ATTACHMENT FEATURE 
STEP 1 
CE INSTALLED 
SEE USER GUIDE 


This box contains parts for your display. These must be installed 
by the service representative before you can cable the IBM 
Personal Computer 3270 Attachment Option to the display 
station. | 
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IBM 3270 PC ATTACHMENT FEATURE 
STEP2 _ 

USER INSTALLED 

SEE USER GUIDE 


This box contains parts that must be installed on the system 
unit. 


L] If the parts are still in the boxes, open box 2; unpack and 
lay out the parts. 


LJ If your display station is a new installation, set it up per 
the customer setup instructions shipped with the display; 
then return here. 


Responsibilities of Your Service Representative 


ie 


Have your service representative install the IBM 3278 or the 
3279 Personal Computer Adapter. If your 3278 display has the 
IBM 3278 Personal Computer Adapter installed, the back of the 
display looks like Figure 2-1. If your 3279 Color Display has the 
IBM 3279 Personal Computer Adapter installed, the back of your 
display looks like Figure 2-2. If the back of your display does not 
look like Figure 2-1 or Figure 2-2, stop setup until the IBM 3278 
or 3279 Personal Computer Adapter is installed. 


Make sure you have all the items on the Checklist. 
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Figure 2-1. Rear View of a 3278 Display with IBM 3278 Personal 
Computer Adapter Installed 
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Figure 2-2. Rear View of a 3279 Color Display with IBM 3279 
Personal Computer Adapter Installed 
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Checklist 


Before attempting to cable the system unit to the display, you must 
have all of the items listed below. If any item is missing, contact your 
IBM sales representative or your site coordinator. 


Do not continue with the setup until you have all the parts listed. 
Separately Obtained Prerequisite Items 
LC] 3278 Display with the IBM 3278 Personal Computer Adapter 


Installed (see Figure 2-1) or 3279 Color Display with the IBM 
3279 Personal Computer Adapter Installed (see Figure 2-2) 


3278 Display 3279 Color Display 


CL] 3278/3279 Keyboard 
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LJ System Unit 


Note: The system unit can be a 5150 (for the IBM 
Personal Computer) or a 5160 (for the IBM Personal 
Computer XT). The diagrams in this chapter show 
a 5150, but apply for a 5160 as well. 


ANNAN 


L] Color/Graphics Monitor Adapter 
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Parts Supplied with the IBM Personal Computer 3270 


Attachment Option 


LJ Distribution Box 


LI Plastic Card Guide 
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LJ) IBM Personal Computer 3270 Adapter 
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CL] Feature Bus Cable, Part Number 4752127 (on label) ~ 


Helpful Hints for Setup 


You will install the options in the system unit in the following order 
(as outlined in the rest of this chapter): 


1. Additional Memory Modules (Step 5) 
2. The IBM Personal Computer 3270 Adapter (Step 7) 
3. Additional Diskette Drive 


4. Display Adapter (either Monochrome or Color/Graphics) 
(Step 9) 


5. All other options. 
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Readying a System Unit That Is Part of an IBM 
Personal Computer 


If your system unit is part of a currently operating IBM Personal 
Computer, do the following: 


CO 


CO 


O 


O 


Set the system unit On/Off switch to Off. 
Remove the power cord from the power outlet. 
Disconnect the power cord from the system unit. 


Disconnect the keyboard attached to the system unit. 
Remove this keyboard: you do not need it. 


Disconnect the monitor attached to the system unit. 
Remove this monitor: you do not need it. 


Disconnect all other cables from the system unit. 


Go to Step 3 of the procedure “Installing the IBM Personal Computer 
3270 Attachment Option.” 
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Readying 4 New Syste™ Unit 


(_| step 1 
For a new system unit, do the following: 
pe from the diskette drive. 


Cl Remove the ta 


TT 


C1 Lift the lever. 
Lever 


uN 


a 
9 


C1 Remove the shipping cardboard. 
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[J Step 2 


Cl Set the system unit On/Off Switch to Off. 


ose gl 
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Installing the IBM Personal Computer 3270 
Attachment Option 


[_] Step 3 


Move the system unit to an area where you have adequate room to 
remove the cover and to work. Arrange the system unit so that you 
have easy access to both the front and the rear. It is not necessary 

to have the system unit next to the display for this part of the option 
installation. 


You need a flat-blade screwdriver for installing the options and the 
cables. (A 3/16-inch nutdriver may be used.) 


[CL] Remove the cover mounting screws from the system unit. 
Save these screws for reinstalling the cover. 


Cover Mounting Screws 
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Most system units have five cover mounting screws as illustrated. 
Some earlier models have only two cover mounting screws (the two 
lower ones). Remove them. Discard the screw from the upper right; 
save the other four (if using the earlier model, save both screws). 


[_] Step 4 


L] Carefully slide the system unit cover away from the rear and 
toward the front of the system unit as indicated below. When 
the cover goes no further, tilt the cover up and remove it from 
the base. Set the cover aside. : 


—~s Sa i. | =. — 


om (GE a) 2 


Front 


Front 2 Sage. 
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[_] Step 5 


If you have any additional memory modules, install them now. 


[_] Step 6 


L] Look at the inside left rear of your system unit. 
There are five expansion slots (eight slots for the Personal 
Computer XT). If all the expansion slots are filled, see your 
sales representative. You must install the IBM Personal Com- 
puter 3270 Adapter in expansion slot 1. If this system unit was 
part of an IBM Personal Computer system and there is a card 
in expansion slot 1, remove this card and install it later in an 
empty expansion slot. Save the screw that was removed from 
expansion slot 1. 


Rear Panel 


Expansion Slot 
No. 1 


a 
KY, 1, 
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L] Using a flat-blade screwdriver or a 3/16-inch nutdriver, remove 
the screw that holds the system expansion slot cover in place 
by turning the screw counterclockwise (¥ )). 


cow 
E Screw 
| 


Rear Panel 


Expansion Slot 
No. 1 


Ll Save the screw for installation of the IBM Personal Computer 
3270 Adapter. The system expansion slot cover is no longer 
needed. 


Setup and Option Installation 2-17 


[] Step 7 


O Align the plastic card guide, pointer down, and snap it in place 
(in expansion slot 1) as shown. : 


Front 
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Plastic Card Guide in Place 


Front. 
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[_] Step 8 


Install the IBM Personal Computer 3270 Adapter in expansion 
slot 1. Make sure the connector on the card is firmly seated in 
the socket. Do not be afraid to apply pressure. 


2-20 Setup and Option Installation 


Retaining Bracket Notch 


| 
=r | 
A 


L] Align the notch in the option retaining bracket with the hole 
in the rear panel of the system unit. Start the screw clockwise 
(Cy) and screw in snugly. Turn the screw counterclockwise 
(¢ )) one-half turn. You must leave this screw loose until the 
distribution box is connected. 
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L] Step 9 


L] If you have any other options to install, install them by following 
the installation instructions that were shipped with the option. 


CAUTION 

Do not connect the power cord or try any diagnostic testing of the 
options at this time. Do any required test after you have completed 
setup of the IBM Personal Computer 3270 Attachment Option. 


You may save time if you install these options in the following 
sequence: 


1. Additional Diskette Drive 
2. . Display Adapter (either Monochrome or Color/Graphics) 


For Display Adapter switch setting installation, consider the 


following: 

When the adapter Set the switch for 

card is for: monitor type: 
Monochrome Display and IBM Monochrome Display 
Printer 

Color/Graphics 80 X 25 Color 


3. All other options. 


After all options have been installed, return here to continue with 
the setup. 
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CJ Step 10 


LI Align the distribution box connector with the IBM Personal 
Computer 3270 Attachment Option card connector. Connect 
the distribution box to the card by pushing the distribution 
box connector against the card connector as far as it goes. 


IBM Personal Computer 
3270 Attachment Option Card Connector 


CL] With a flat-blade screwdriver, tighten the screws on the 
distribution box. 


L] Tighten the screw in the retaining bracket for the IBM 
Personal Computer 3270 Attachment Option card (Step 7). 
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O Step 11 


O 


Front 


Replace the system unit cover by positioning the cover as shown 
and carefully sliding it toward the rear of the system unit. 


ae) 


> 
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Front 
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CL Step 12 


L] When the cover is all the way to the rear, align the cover mount- 
ing screws with the threaded tabs. Using a flat-blade screwdriver, 
replace the two lower screws removed in Step 3 and tighten 
by turning them clockwise (( ¥). (If you are using an older 
model, these are the only screws replaced.) Then, replace the 
additional two screws removed from Step 3 by inserting them in 
the top left and center mountings and tightening them. The top 
right mounting screw is not used. 


. Threaded 
Tab 


Cover 
Screw 


Your system unit is now ready to be cabled to the display. 
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Cabling the System Unit to the Display 


Refer to the Checklist for the part numbers of the cables. 


[] Step 13 


L] Set the display On/Off switch to the off position (O). 


im 
po 


L]. Remove the display power cord from the power outlet. 


2-26 Setup and Option Installation 


a Step 14 


Li Move the system unit to the display station area. 


LI Place the system unit so that it is to the right of the display, 
as shown. 


Kn FEC PR RP ETE PO NA Rion I — 
ny * v PD bth PED fake fd if § fd bad tie 2. 8 eh,e) 
eee UAAUAUUAATUUUE Loder 


LI Arrange the display and the system unit for easy access to the 
front and rear. 
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[] Step 15 


L] Align the video cable connector (the end with the screws) with 
the monochrome or color/graphics card connector. Connect 
the cable to the card by pushing the cable connector against 
the card connector as far as it goes. 


LJ) Tighten the screws with a flat-blade screwdriver. 


Video Cable 
Monochrome Card Connector 


Video Cable 


Video Cable 
Color/Graphics Card 
Connector 


With Color/Graphics Monitor Adapter (Bottom Connector) 
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C1 Step 16 


L] On the back of the display, align the video cable connector 
(the end with the latches) with the smaller display connector. 
Connect the cable to the display by pushing the cable connector 
against the display connector until it latches. Remove the screw 
from the 3279 by turning it counterclockwise (¥ )). 


3278 Display 


Display 
Connector 


Video Cable Connector 


Video Cable 
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3279 Color Display 


Video Cable Connector 


Video Cable Screw 
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LJ Step 17 


L] Align the keyboard adapter cable connector (the end with the 
pigtail attached) with connector A on the left side of the 
distribution box. Connect the cable to the distribution box by 
pushing the cable connector against connector A until the latches 
catch. 


Keyboard 
Adapter Cable 
Pigtail Lead Socket 


Connector A 


Keyboard Adapter Cable 
Keyboard Connector 
Adapter Cable 
Pigtail Lead Keyboard 


Adapter Cable 
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(1 Plug the pigtail lead connector into the socket labeled Keyboard 
on the rear of the system unit (the socket on the left). 


Keyboard Adapter Cable 
Pigtail Lead Socket 
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LJ Step 18 


CL] Align a feature bus cable connector (the end without the part 
number label) with connector B (the center one) on the distribu- 
tion box. Connect the cable to the distribution box by pushing 
the cable connector against connector B until the latches catch. 


By Connector B 


Feature Bus Cable | 
Connector (distribution box end, 
=> the end without the label) 


ES Feature Bus Cable 


rebel 
rxttis 


Label 


}~<—— Display End 
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LJ Step 19 


[J On the back of the display, align the other feature bus cable 
connector with the display connector. Connect the cable to the 
display by pushing the cable connector against the display con- 
nector until the latches catch. 


3278 Display 
Display Connector 


Feature Bus Cable Connector 


‘f 


Feature Bus 
Cable MED 
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3279 Color Display 


Feature Bus Cable 
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L] Step 20 


If you have a 3279 display, go to Step 25; otherwise, continue 
here. 


L] Open the display front cover by pushing the latch (located under 
the front center edge of the display) away from you toward 
the machine. 
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C1 Remove the front cover by lifting it off the pivot pins (one on 
each side, at the bottom where the front cover meets the 


display). 
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[] Step 21 


[1 Under the cover, find the keyboard cable connector. To remove 
the keyboard cable connector, unlatch the retainer wire by 
pressing in and to the left to clear the latch. Then lift the 
retainer wire, and swing it to the left. 


Keyboard Cable Connector 


Retainer Wire 


Wing Nut 
Keyboard Cable Clamp 


[L] Remove the wing nut by turning it counterclockwise (W). 
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[_] Step 22 


LI Pull the keyboard cable connector out, and remove the keyboard 
cable clamp from the stud. 


os 
\\i— Keyboard Display Connector 


‘Keyboard Cable Connector 


Stud 


‘Keyboard Cable Clamp 


To Keyboard 


LJ Move the keyboard out of your way. The keyboard cable will be 
connected to the distribution box later. 
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@ Step 23 

L] Place the keyboard adapter cable clamp on the stud. 

CL] Connect the keyboard adapter cable to the display by pushing 
the cable connector against the right-hand display connector, 


above the letters KEYBD, as far as it goes. 


LJ Replace the wing nut on the stud and tighten by turning it 
clockwise ((¥). 


2 
\Y Keyboard Display Connector 
\ 
me Keyboard Adapter Cable 
Connector 


Stud 


Keyboard Adapter Cable 
Clamp 


To System Unit 
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LJ Step 24 


C] 


CO 


Check that any cables to be held by the retainer wire are properly 
plugged into their sockets. 


Swing the retainer wire across the cable connector. Insert the 
bottom of the retainer wire in the slot, and latch it into place. 
The retainer wire keeps the connector tightly in place; it 
therefore takes some extra force to latch it into place. Do not 
be afraid to apply the necessary force. 


Remember, if the device cable is not attached, follow the 
Customer Setup Instructions for your display to attach it at 
this time. 


Position the power cord, the device cable, the keyboard adapter 
cable, and the other cables so that they do not interfere with 
closing the front cover. 


Install the front cover on the pivot pins. Close the cover, and 
slide the cover latch toward you. 
Go to Step 26. 


Device 
Cable \ | 
. Keyboard Adapter Cable Connector 


pre 2 


ld 


Al Replace 

8 retainer wire 
bottom 
first 


<@——To System Unit 
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LJ Step 25 
For a 3279 Color Display: 
Unplug the keyboard cable and remove it from the display. 
Place the keyboard adapter cable clamp on the stud. 


Connect the keyboard adapter cable to the display by pushing 
the cable connector against the display connector as far as it goes. 


Replace the screw and tighten it by turning it clockwise ((¥). 
Remember, if the device cable is not attached, follow the 


Customer Setup Instructions for your display to attach it at 
. this time. 


Screw Keyboard oes 
Adapter 
Cable 
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[_] Step 26 


LJ Position the keyboard so that the keyboard cable reaches the 
distribution box. . 


L] Remove the wing screw from the distribution box by turning 
the wing screw counterclockwise (¥ )). 


si Wing Screw Stud 


Wing Screw 
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CJ Step 27 


L] Align the keyboard cable connector with connector C on the 
right side of the distribution box. Connect the cable to the 
distribution box by pushing the cable connector against 
connector C as far as it goes. 


Keyboard Cable Connector 


Hy Connector C 
A 


=~ Keyboard Cable 


ith 
ith 
ath 
Htttie. 
ttt 
Stitiittit, 
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“ee, To Keyboard 


Wing Screw 
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L] If necessary, move the keyboard cable clamp so that it lines up 
with the wing screw stud. Insert the wing screw into the stud, 
and tighten the wing screw by turning it clockwise (( \). 


Keyboard Cable Connector 


Keyboard Cable 


Wing Screw 
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L_] Step 28 


Your cabling of the IBM 3270 Personal Computer Attachment is 
completed. The rear of your system unit should look like Figure 
2-3, and the rear of your display should look like Figure 2-4 or 2-5. 


The keyboard adapter cable, the video cable, and the feature bus 
cable should be cabled to the display. The keyboard cable should 
be cabled to the keyboard. 


Video Cable 


Keyboard Adapter 
Cable Pigtail 


Keyboard Adapter 
Cable 


Feature Bus 
Cable 


Figure 2-3. Rear View of a System Unit Cabled for IBM 3270 
Personel Computer Attachment 
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IBM 3278 


Feature Video Video 
Bus Test Cable 
Cable Switch 


Figure 2-4. Rear View of a 3278 Display Cabled for IBM 3270 
Personal Computer Attachment 
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Figure 2-5. Rear View of a 3279 Color Display Cabled for 
IBM 3270 Personal Computer Attachment 
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LC] Step 29 


L] Make sure that the system unit On/Off switch is set to Off. 
CAUTION 
Be sure to connect the power cords of the system unit and of the 


display to the same branch supply (wall outlet). 


CL] Plug the system unit power cord into the system unit power 
cord socket. 


L] Now plug the system unit power cord into the power outlet. 


Power Cord: 
Socket 


Connect this 
end first 


System Unit Power Cord 
Power Outlet 


L] Plug the display power cord into its power outlet. 


The option installation is completed. Now continue with the 
Power-On Self-Test. 
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Power-On Self-Test (POST) 
LJ Step 1 


C1) Set the display On/Off switch to the On position (| ). 


» On 
NY Off 


For a 3278 display, turn the contrast 


brightness CQ controls clockwise ( ~Y) as far as they go. 
L] Fora 3279 display, turn the brightness 


PO control clockwise (( ¥) as far as it goes. 
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[_] Step 2 

Note: When performing tests or diagnostics, disconnect any external 

devices that may be connected to your asynchronous communication 

adapter. 

When you first switch on the system unit, the Power-On Self-Test 

(POST) is run. This test usually takes from 3 to 45 seconds, and 

several responses occur during the test. Please note the responses. 

LJ] Set the system unit On/Off switch to On. — 

Notes: 

1. Onsome models of the 3279 Color Display Station, the screen 
may have an unstable image and multiple images. This condition 
is normal for this step. 

2. Onsome models of the Personal Computer system unit, a 
momentary 301 message appears on the screen. This condition 
is normal for this step. 

You receive these responses: 

1. Accursor appears on the screen. 


2. You hear one short beep. 


3. The IBM Personal Computer Basic message appears on the screen. 
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Note: These responses tell you that the self-test has been completed 
successfully. Other information appears on the screen but is not 
important at this time. 


CL] Adjust the display contrast and brightness for viewing comfort. 
The setup is completed. 


If the responses were correct, your system is ready for customization. 
See Chapter 3. , 


If the responses were incorrect, go to Entry Point 205 of Problem 
Determination Procedure 2 in Chapter 6. 


Notes: 

1. Keep the packaging materials and containers; store them in a 
safe place. Use these materials and containers if the system unit 
has to be returned for service. 

2. The 3278/3279 keyboard can only be used with the system unit 


On/Off switch in the Off position until the DOS customization 
is completed in Chapter 3. 


2-52 Setup and Option Installation 


Chapter 3. Customization 


Introduction 


This chapter shows you how to build a system diskette for use 
on the 3278 or 3279 display station with the IBM 3270 Per- 
sonal Computer Attachment. You must complete Chapter 2 
of this manual before customizing. 


The customization procedure is performed in personal computer 
mode. The machine does not require keyboard input until you 
are prompted by a menu. At that time, follow the directions on 
the screen. The customization procedure combines the infor- 
mation on your IBM Personal Computer DOS diskette(s), sup- 
plied in your IBM Personal Computer DOS book, with the 
information on the IBM Personal Computer 3270 Attachment 
Option Customization diskette and puts it all on a third diskette. 


IBM Personal IBM Personal Computer 
Computer DOS 


3270 Attachment Option 
Customization 


IBM Personal Computer 
3270 Option DOS 
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At the end of the procedure, the IBM Personal Computer 3270 
Attachment Option DOS diskette takes the place of the IBM 
Personal Computer DOS diskette. Any time you need to use 
your DOS diskette in the future, make sure you use the IBM 
Personal Computer 3270 Attachment Option DOS diskette. 
Save the IBM Personal Computer DOS diskette and the IBM 
Personal Computer 3270 Attachment Option Customization 
diskette for backup. 


Getting Started 


Before you begin, you will need: 


@ Your IBM Personal Computer DOS diskette(s) (distributed 
with the JBM Personal Computer Disk Operating System 


manual) 
e Your IBM Personal Computer 3270 Attachment Option 


Customization diskette (distributed with the JBM 3270 
Personal Computer Attachment User’s Guide) 


e A blank diskette (supplied by you). 
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Identifying Your Keyboard and Choosing a 
Keyboard Reference Card 


During the customization procedure, the menu asks you to 
identify the keyboard language and the possible request for 
price quotation (RPQ) that apply to your 3278/3279 key- 
board. Figures 3-1 through 3-16 show layouts of the keyboards 
supported. If you do not know which keyboard you have, com- 
pare each layout with your keyboard. 


Note that several keys on each keyboard layout are highlighted 
(white). When the corresponding keys on your keyboard match 
the highlighted keys on the layout, check all the other keys to 
make sure that this is your keyboard. If not, keep going until 
you find a match. Make sure your keyboard matches all the 
keys on the layout. If you cannot find your keyboard among 
the layouts provided, contact your IBM sales representative and 
stop customization. 


At the end of this manual are 16 Personal Computer Mode Key- 
board Reference Cards (referred to as keyboard reference cards 
throughout this manual), which fold out for use in personal 
computer mode. The areas highlighted on the keyboard refer- 
ence card show the IBM Personal Computer key functions that 
do not have an equivalent label on the keyboard. The areas not 
highlighted show the key functions that are the same (or similar) 
in both personal computer and host computer modes. The key- 
board reference card you should use is specified in the Note in 
Figures 3-1 through 3-16. This keyboard reference card can be 
folded up against the edge of the manual (when the manual is 
not in use) for reference during personal computer mode. 
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Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 1. 


Figure 3-1. 87-Key EBCDIC Typewriter Keyboard 


use Personal Computer Mode Keyboard Reference Card 2 
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Note: In personal computer mode, 
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Keyboard Reference Card 3. 
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Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 5. 


Figure 3-5. 87-Key EBCDIC Typewriter Keyboard with RPQ 8K1038 


6-€ UwoNnezIuo}sny 


Red 


Pink 


Green 


Yellow 


Blue 


Turquoise 


White 


Note that the shape of the highlighted keys is different from that of the other keys. 
Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 6. | 


Figure 3-6. 87-Key EBCDIC Typewriter Overlay Keyboard 
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Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 7. 


Figure 3-7. 87-Key EBCDIC Attribute Select Typewriter Keyboard 
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Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 8. 


Figure 3-8. 87-Key EBCDIC Attribute Select Ty pewriter/APL Keyboard 
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Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 9. 


Figure 3-9. 87-Key EBCDIC Typewriter/TEXT Keyboard 
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Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 10. 


Figure 3-10. 87-Key EBCDIC Typewriter Keyboard with RPQ 8K0932 
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Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 11. 


Figure 3-11. 87-Key EBCDIC Typewriter Keyboard with RPQ 8K0731 
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Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 12. 


Figure 3-12. 75-Key EBCDIC Typewriter Keyboard 
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use Personal Computer Mode Keyboard Reference Card 13. 
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Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 14. 


Figure 3-14. 75-Key EBCDIC Data Entry Keyboard 
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Note: In personal computer mode, use Personal Computer Mode Keyboard Reference Card 15. 


Figure 3-15. 75-Key EBCDIC Data Entry Keypunch Keyboard 


use Personal Computer Mode Keyboard Reference Card 16 
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-Key EBCDIC Data Entry Keyboard with RPQ 8K0732 
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The Customization Procedure 


1. Set up your system unit On/Off switch to Off before you 
begin. | 


2. Set the display On/Off switch to the On position (| ) if the 
display is not already on. 


3. Make sure the system unit diskette drive is empty. Then 
insert the IBM Personal Computer 3270 Attachment Option 
Customization diskette into drive A of your system unit 
and close the door. (If you have only one diskette drive, 
the customization procedure is the same as for two diskette 
drives, except that you use only the “‘A”’ diskette drive. 
The system will prompt any action required of you.) 


4. Set the system unit On/Off switch to On and wait for the 
system unit to warm up. You will see the following mes- 
sages on the screen: 


IBM Personal Computer 3270 Attachment Option 
Customization Program 
Version |.10 (C)Copyright IBM Corp. 1982, 1983 


Keep the following diskettes ready: 

The IBM DOS System diskette(s) (the diskette(s) distrib- 
uted with the DOS book) 

anda BLANK diskette (this diskette need not be formatted) 


From here on, you will be prompted by the system. Wait 
for the message to appear on your screen before taking any 
action. 


Please REMOVE (name of diskette) diskette from drive 
(name) 

Please INSERT (name of diskette) diskette from drive 
(name) 


These two messages are displayed until you place the 
required diskette in the specified drive, and a beep period- 
ically sounds. Do not be concerned if the red light on the 
diskette drive is already on before you insert your diskette. 
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The system checks whether the diskette has already been 
inserted. Wait for these messages before you insert a 
diskette. 


Check that you have the correct diskette in the correct 
diskette drive, and close the diskette drive door. If the 
diskette drive door is left open, the message 


Close the diskette drive door 


appears on your screen and a beep periodically sounds until 
the door is closed. Close the door, and the machine begins 
reading the diskette. 


If a diskette with a write-protect tab is in the diskette drive 
that required a blank diskette, the messages 


Diskette is write protected 
Please REMOVE this diskette and 
INSERT the BLANK diskette without the tab 


appear on your screen. Remove this diskette, and insert 

the blank diskette without a write-protect tab on it. A 

beep periodically sounds until you insert the blank diskette. 
These two messages may also occur if a write-protected 
diskette inserted in the diskette drive in the preceding step is 
still in the diskette drive and a blank diskette is now 
required for this step. 


The system begins to write on the blank diskette. A few 
minutes after inserting the blank diskette, you might see 
linker (LINK) information on your screen. You can ignore 
this information. The customization process is taking 
place. Do not open the diskette doors or remove the disk- 
ette until you see further information; otherwise, you will 
prevent completion of the cusomization process. 


When the machine stops processing, you see a menu and are 
asked to indicate the keyboard language supported by your 
system. (This is where the keyboard and RPQ information 
you found before is given to the system.) Using the Cursor 
Up (t) and Cursor Down (J) keys, move the cursor under 
the asterisk next to your keyboard language and press any 
alphanumeric key. 
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6. Next, do the same as in step 5 with the keyboard RPQ that 
applies to your system. For example, if no RPQ applies, 
move the cursor under the asterisk next to NO RPQ and 
press any key. You see more linker information on your 
screen. For example, if you identified your keyboard as an 
RPQ keyboard, you must inform the system. Move the 
cursor to the correct RPQ and press ENTER. 


7. When the system stops processing (you see concluding 
messages and an A >), the DOS customization is completed. 
The original blank diskette contains your new DOS system. 
(This diskette is single-sided.) 


If, when you type, you see symbols on your screen that do 
not match your keyboard, you specified the wrong key- 
board in steps 5 and 6. You must restart the customization 
process from the beginning. If the procedure does not 
work, try the procedure again before calling your IBM sales 
representative. 


Label your new diskette JBM Personal Computer 3270 
Attachment Option DOS. 
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Customizing for Your Needs 


Now that you have customized a diskette for the IBM 3270 Per- 
sonal Computer Attachment, you will want to customize the 

- same diskette for typical system and application needs. The 
diskette you just customized contains: 


AUTOEXEC.BAT file 
COMMAND.COM file 
3270ATT.EXE file 
ERASE__ ME.BAT file 
Two other hidden DOS files 


The IBM Personal Computer DOS diskette (supplied with your 
IBM Personal Computer DOS Guide to Operations) contains 
many more files which did not transfer to your newly custom- 
ized IBM 3270 Personal Computer Attachment Option DOS 
diskette. You will need some of these DOS files for your 
normal operations as well as other files to support your appli- 
cations. The next two sections, “Customizing Your System 
Disk” and “‘Customizing Your Application Disk(s),” will help 
you customize for your own needs. 


Note: The following operations require knowledge of IBM 
Personal Computer DOS commands. Refer to your JBM Per- 
sonal Computer DOS manual for information. Remember 
that the term disk refers to a diskette or fixed disk. 
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Customizing Your System Disk 
Follow the steps below to build your system diskette: 


1. Erase ERASE__ME.BAT (left over from your earlier cus- 
tomization steps) from the IBM 3270 Personal Computer 
Attachment Option DOS diskette you just built. 


2. Copy other IBM Personal Computer DOS files you will 
need onto your IBM 3270 Personal Computer Attachment 
Option DOS diskette. (For example, you will need the 
FORMAT file to format additional diskettes for use on the 
IBM Personal Computer. Be careful: You can destroy all 
the information on your fixed disk if you use the FORMAT 
command incorrectly.) (Refer to the JBM Personal Com- 

_ puter Disk Operating System manual for this information. 


3. Add any additional commands you require to the 
AUTOEXEC.BAT file on your IBM 3270 Personal Com- 
puter Attachment Option DOS diskette. This completes 
your system diskette. Now, this diskette is self-loading, 
which means it can be inserted to power up the system unit 
or used with a keyboard system reset. 


Notes: 


a. The 3270ATT command must always be the first entry 
in the AUTOEXEC.BAT file for the IBM 3270 Personal 
Computer Attachment. The AUTOEXEC.BAT file is 
always needed on the diskette that you use to start the 
system (a self-loading diskette). For more information 
about the AUTOEXEC.BAT file, refer to “Batch 
Processing” in Chapter 2 of the JBM Personal Computer 
Disk Operating System manual. Chapter 2 also con- 
tains information about creating a double-sided system 
diskette. 
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The personal computer 3270 interrupt handler 
(3270ATT.EXE) automatically modifies the display 
parameters for both the IBM Monochrome Display 
Adapter and the IBM Color/Graphics Display Adapter 
for use with the 3278 or 3279 display station. 


If both display adapters are installed in your personal 
computer, you can request 3270ATT to modify only 
one set of display parameters. If you add the MONO 
option to the 3270ATT command in your 
AUTOEXEC.BAT file, the interrupt handler modifies 
only the parameters for the monochrome display 
adapter. If you add the COLOR option, the interrupt 
handler modifies only the parameters for the color/ 
graphics display adapter. 


You cannot successfully complete an IBM Personal 
Computer system reset unless you have a self-loading 
application diskette or the IBM Personal Computer 
3270 Attachment Option DOS diskette in drive A of 
your system unit. If you try an IBM Personal Com- 
puter system reset with a diskette that is not custom- 
ized for the IBM 3270 Personal Computer Attachment 
in drive A, the keyboard will be inoperative. To cor- 
rect this: 
(1) Using a system diskette: 

(a) Ignore any messages on the display. 

(b) Insert the correct diskette in drive A. 

(c) Set the system unit On/Off switch to Off. 

(d) Wait 5 seconds. 

(e) Set the system unit On/Off switch to On. 
(2) Using a system fixed disk: 


(a) Ignore any messages on the display. 


(b) Remove any diskette from drive A. 
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(c) Set the system unit On/Off switch to Off. 
(d) Wait 5 seconds. 


(e) Set the system unit On/Off switch to On using 
the system fixed disk. 


4. If you wish, you can transfer all the information from your 
system diskette to a fixed disk. (The term system disk 
refers to a system diskette or to a system disk for the rest 
of this manual.) Simply follow disk formatting instructions 
in the JBM Personal Computer DOS manual. Be sure the 
AUTOEXEC.BAT file for the fixed disk includes the 
3270ATT entry as its first entry. Also be sure that you 
copy 3270ATT.EXE to the fixed disk. 
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Customizing Your Application Disk(s) 


Now that you have your system disk completed, you can begin 
building your application disk(s). 


Application program disks usually come with a set of instruc- 
tions for copying selected IBM Personal Computer DOS files 
onto the application disk. In addition to these instructions, you 
must use your system disk and do the following: 


1. Copy the 3270ATT.EXE file onto the application disk. 


2. Change the application disk AUTOEXEC file so the first 
command is 3270ATT. If your application disk does not 
have an AUTOEXEC file, copy the one from your system 
disk. 


Examples 


The above instructions are helpful in general cases, but here are 
some tips for specific applications: 


e If you use the IBM Personal Computer DOS FORMAT 
command with /S, or the SYS command, you must also copy 
the 3270ATT.EXE file and the AUTOEXEC.BAT file (con- 
taining the 3270ATT command) onto the target disk. This 
allows you to use the target disk as a self-loading disk. 


@ The IBM Personal Computer 3270 Attachment Option 
interrupt handler takes up some memory after installation. 
For this reason, personal computer application programs 
that just fit into 64K will require additional memory to run 
on the IBM 3270 Personal Computer Attachment. 


@ The IBM Personal Computer 3270 Attachment Option 
interrupt handler also takes up diskette space. As a result, 
some of your personal computer application programs that 
were stored on self-loading diskettes might not fit on a 
diskette with the IBM 3270 Personal Computer Attach- 
ment. You can move these application programs to your 
fixed disk or continue to run them from diskette. 
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To execute them: 


1. Load the system diskette. When it has been loaded, 
you will see A > on the screen. 


2. Remove the system diskette, and insert your applica- 
tion diskette. 


3. Enter the command 
AUTOEXEC 
This will start your application diskette. 


e Ifyou wish to run Science Research Associates (SRA’ ) 

' application programs on the IBM 3270 Personal Computer 
Attachment, customize the application program diskette, 
following the procedure at the beginning of this section. 
After an SRA program diskette is customized, the 
AUTOEXEC file must be modified. Before loading the 
SRA program diskette, add the 3270ATT command at the 
beginning of the AUTOEXEC file and change the com- 
mand COLOR to LOGO. 


Building a Diagnostics Diskette 


As an example of an application disk, you need to build a 
Diagnostics diskette. You build it by copying all the files on 
your system diskette to a blank formatted diskette, which will 
become your Diagnostics diskette. Copy the 3270DIAG.EXE 
file from your customization diskette to your Diagnostics 
diskette. Store the Diagnostics diskette where it will be 

easily accessible if you need it for the problem determina- 
tion procedures in Chapter 6. 


Preparing for Data Transfer 


You may prepare your new system disk for data transfer at this 
time. The process is described under “‘Preparing for Data Trans- 
fer” in Chapter 5. If you prefer, you can wait until you need to 
use the data transfer function. 


1 Registered trademark of Science Research Associates 
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Chapter 4. How to Operate and Use the 
Keyboard 


Operating Sequence 

Now that you have set up and installed all your options (Chap- 

ter 2) and built your system disk (Chapter 3), your IBM Personal 

Computer is ready for operation. Your daily operating sequence 

will be similar to the following: 

1. Ready your system disk. (This means you insert your 
system diskette in drive A, or you remove any diskette 
from drive A to allow the system fixed disk in drive C to 
be used.) 

2. Set the display On/Off switch to the On position (|). 

3. Set the system unit On/Off switch to On. 


The Power-On Self-Test (POST) will run every time the 
system unit is powered on. 


4. When POST is completed: 


a. In personal computer mode, follow your IBM Personal 
Computer operating procedures. 


b. In host computer mode, follow your host operating 
procedures. 


5. Terminate operations with the appropriate procedure. 
6. Set the system unit On/Off switch to Off. 


7. Set the display On/Off switch to the Off position (0). 
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How to Switch Modes from the Keyboard 


You switch modes by pressing the following keys: 


@ On TEXT keyboards, press and hold ALT, and then press 
PAI. 


e On all other keyboards, press and hold ALT, and then press 
the Insert (Ay) key. | 


If the display station is in host computer mode, it switches to 
personal computer mode. If in personal computer mode, it 
switches to host computer mode. You use the mode switch key 
combination in both host computer and personal computer 
modes. 


In host computer mode, your system unit, keyboard, and dis- 
play operate as a 3278 or 3279 display station. In host com- 
puter mode, the display screen has an operator information area 
(OIA) and user display space. See Figure 4-1. 


Figure 4-1. Host Computer Mode Display 


4-2 How to Operate and Use the Keyboard 


In personal computer mode, the display screen has no operator 
information area. See Figure 4-2. 


Figure 4-2. Personal Computer Mode Display 


The shapes of the characters displayed in personal computer 
mode differ from those of the same characters displayed in host 
computer mode. In host computer mode, the characters are 
generated by the 3278 or 3279 display station. In personal 
computer mode, the characters are generated by the personal 
computer. 
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Using the Keyboard in Host Computer Mode 


The keyboard is the input device for your display station with 
the IBM 3270 Personal Computer Attachment. The keyboard 
performs 3278/3279 functions when in host computer mode. 
All the functions engraved on the keytops are performed when 
each key is pressed, except for the mode switch, explained 
previously. 


Using the Keyboard in Personal Computer Mode 


In personal computer mode, the keyboard performs the func- 
tions of an IBM Personal Computer Keyboard. Some of these 
functions are not engraved on the 3278/3279 keyboard keytops. 
To help you locate the keys that perform the IBM Personal Com- 
puter functions, the keyboard reference cards at the back of 

this manual show the IBM Personal Computer Keyboard func- 
tions mapped to a layout of the keyboard. In addition, 

Table 4-1 shows commonly used key sequences referred to in 
the IBM Personal Computer documentation you received with 
your system unit. 


Changing the Keyboard Mapping 


You might use the XLATKBD program on the Attachment 
Option Enhancements diskette to change the standard mappings 
between the personal computer keyboard and the 3278/3279 
keyboard (as shown on the keyboard reference cards). Run the 
XLATKBD program for instructions. 


Using the Keyboard Reference Cards 


The keyboard reference cards duplicate some of the functions 
on the keyboard layouts (Figures 3-1 through 3-16). Use the 
functions defined on the keyboard reference card you selected 
for your keyboard. The highlighted keys on the keyboard 
reference card show the functions that your keyboard performs 
when the display station is in personal computer mode. This 
keyboard reference card, not the key engravings, must be used 
when the display station operates in personal computer mode. 
For example, if the display station is in personal computer 
mode and your application supports page up, press the ALT and 
Cursor Up (7) keys together. This performs the page-up func- 
tion. Refer to the IBM Personal Computer manuals for instruc- 
tions on how to use the personal computer. 
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Commonly Used Key Sequences 


Table 4-1 lists the key sequences found in IBM Personal Com- 
puter manuals and the keyboard keys you press to perform 
that personal computer function. 


You should remember that most IBM Personal Computer key 
functions are application-dependent. The same key sequence 
might not perform the same function in two different applica- 
tions. Refer to the IBM Personal Computer manuals for the 
differences. oo 
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Table 4-1. Commonly Used Key Sequences 
Personal Computer 3278/3279 Key 
Key Sequence Sequence Comments 
ALT CTRL Del PAL @ IBM Personal Com- 
puter system reset. 


ESC ALT PA3 Data Entry 
keyboards. 
ALT All others. 
(See keyboard | 
reference card) 
n 


NUM LOCK Not on 3278 There is no 
numeric keypad. 


ALT 


Ins /» 
Del q 


PF1—PF10 
(See keyboard 

reference card) 

F11—F20 

(See keyboard 

reference card) 

F21—F30 

(See keyboard 

reference card) 


ALT F1-F10 F31—F40 - 


Pease foo —~*diCnrsreens | 
CTRL Prt Sc PAI Oa Start/stop echo 
screen to print. 
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Pg Up (page up) ALT t 
Pg Dn (page down) ALT + 


3278/3279 has a 
Shift or Numeric 
Lock (all keys 
shift), not a Caps 
Lock. 


# F1—F10 


CTRL F1—F10 


Table 4-1. Commonly Used Key Sequences 
(continued ) 


Personal Computer | 3278/3279 Key | 

Key Sequence Sequence Comments 

CTRL = ALI == Reverse word. 

CTRL — ALT —> Advance word. 

CTRL End ERASE EOF Delete to end 
of line. 

CTRL Pg Dn ERASE INPUT | Delete to end 
of screen. 

CTRL Home CLEAR 

CTRL Pg Up PAI} 


CTRL A-Z PA1 A—Z PAI makes the 
next keystroke 
operate as if the 
CTRL key were 
held. 


PA2 A—Z PA2 makes the 
PA2 1—0, —,= next keystroke 
operate as if the 
Personal Computer 
ALT key were 
held. 


The first three 
digits (0O—9) 
entered after 
pressing of FIELD 
MARK operate as 
if ALT were held 
and they came 
from the numeric 
keypad. 


Pause. Any 
key except Shift 
(t, 4+), Shift Lock 
( 3) ), or ALT will 
resume operation 
of the personal 
computer. 


FIELD MARK nnn 
(nnn = 0-9) 


ALT 0—9 (on 
numeric keypad) 


CTRL NUMLOCK 
(pause) 
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Table 4-1. Commonly Used Key Sequences 
(continued ) 


Personal Computer | 3278/3279 Key : | 
Key Sequence Sequence Comments | 


CTRL < ALT =< or Move to next line 
| ALT ENTER 
Not available cA Toggles keyboard 
Clicker clicker on/off. 


Not available RESET Cancels ALT, 


CTRL, Scroll 
Lock, and ALT 
0—9 (on numeric 
keypad) functions. 
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Chapter 5. Data Transfer 


Introduction 
Data transfer functions move information from the host to the 
IBM Personal Computer or from the IBM Personal Computer to 
the host. The IBM 3270 Personal Computer Attachment per- 
mits two types of data transfer: 
e Screen capture 


e File transfer. 


Before you can transfer data, you need application programs. 
You can choose from two options: 


e Youcan write your own application programs. 


e Youcan use the sample application programs supplied on 
the diskettes with this book. 


How to Use This Chapter 


This chapter explains the use of the supplied sample application 
programs for screen capture and file transfer. This chapter is 
used with Appendixes A, B, C, E, F, and G because they con- 
cern data transfer also. | 


Appendix A defines the functions that a personal computer 
application program can use to pass data between the personal 
computer application program and the IBM Personal Computer 
3270 Attachment Option for Assembler. 

Appendix B parallels Appendix A for BASIC. 

Appendix C parallels Appendix A for PASCAL. 

Appendix E guides supervisors or system programmers in setting 


up the host and the control unit for screen capture and file 
transfer. | 
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Appendix F provides data formats and translations for the 
data transfer sample application programs supplied. 


Appendix G gives the structures for transferring data between 

the host and the personal computer. This appendix contains 

descriptions for “‘impossible”’ file transfer error messages. 
What Is Screen Capture? 

Screen capture copies the screen image from the host display to 

the personal computer. You can copy this host screen image to 

these output devices: 

e A personal computer diskette 

e. A personal computer fixed disk 


e A personal computer printer. 


You prepare for screen capture in personal computer mode, but 
you capture screens from host computer mode. 


Screen capture requires: 
e A personal computer screen capture application progtam 


e An IBM 3274 Control unit customized for the IBM 3270 
Personal Computer Attachment. 


Screen capture does not require a screen capture application 
program at the host. Any host screen image can be captured. 
For more information about your system’s preparation for 
screen capture, ask your system program or go to Appendix E. 


What Is File Transfer? 


File transfer copies a file from the host to the personal com- 
puter (or vice versa). The original file stays intact. 


For example, you can create a BASIC file on your host system 
and transfer it to your IBM Personal Computer for processing. 
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You prepare for file transfer in personal computer mode, but 
you transfer files in host computer mode. You can transfer files 
in two ways: 

e Using a menu panel 


e Using a straight command. 


Until you understand file transfer well, you should use the 
menu method. 


File transfer requires: 
e A personal computer file transfer application program 


e An IBM 3274 Control Unit customized for the IBM 3270 
Personal Computer Attachment 


e A host file transfer application program. 
For more information abour your system’s preparation and 


setup for file transfer, ask your system programmer or go to 
Appendix E. 


A Guide to Special Notation 


Throughout this chapter, the formats of the commands use the 
syntax notation described below: 


e Uppercase Characters 
Command name or operands consisting of uppercase char- 
acters must be spelled as shown, but can be entered in 
uppercase or lowercase. 

e Lowercase Characters 
Lowercase characters are variables that show the kind of 
information, rather than the exact information, that must 


be supplied. The actual entry replaces the lowercase 
description. 
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e@ Square Brackets [ | 


When square brackets enclose an operand, they indicate a 
completely optional specification. This includes any 
accompanying commas or equal signs. Square brackets are 
not included when the specification is entered. 


e Or-Sign | 


The or-sign is used to separate options for a single optional 
or required specification. If a group of options is shown 
and the individual options are separated by or-signs, one of 
the options in the group can be chosen. If none of these 
operands is coded, the default value is used. 


@ . Commas and Parentheses 
Commas and parentheses must be entered as shown. When 
they appear within brackets, they are optional and are to be 
used only if the accompanying operand is used. 
A Guide to Data Transfer Sample Application Programs 
Several data transfer sample application programs are included 
on the diskettes that come with this book. Since you should 


understand the names and functions of the sample application 
programs, a guide to them is given in Table 5-1. 
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Table 5-1. A Guide to Data Transfer 
Sample Application 


Programs 


HOST.EXE Supports screen capture and file trans- 
fer for the IBM Personal Computer. 


(You find HOST.EXE on the 
Customization diskette.) 


These three files must be present in a 
CMS host for file transfer: 


PCXFER MODULE Transfers files between a CMS host 
and an IBM Personal Computer. 


PCXFER EXEC Runs PCXFER MODULE or uses the 
Interactive System Productivity 
Facility (ISPF) to run PCXFER 
MODULE with a menu. 


PROFILE PCXFER Contains the default values for 
PCXFER MODULE. 


These two files are optional for file 
transfer in a CMS host: 


PCXFER MACLIB Supports ISPF panels. 
PCXFER HELPCMS Provides online information about file 


transfer when you use CMS HELP 
command. 


(You find all five files for CMS on the 
data transfer: VM/CMS diskette.) 
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Table 5-1. A Guide to Data Transfer 
| Sample Application 
Programs (continued ) 


These two data sets must be present in 
a TSO host for file transfer: 


PCXFER.LOAD Transfers data sets between a TSO 
host and an IBM Personal Computer. 


PCXFER.PROFILE Contains default values for 
PCXFER.LOAD. 


PCXFER.CLIST Runs PCXFER.LOAD or uses ISPF to 
run PXCFER.LOAD with a menu. 


These two data sets are optional for 
file transfer in a TSO host: 


PCXFER.PANEL Supports ISPF panels. 


PCXFER.HELP Provides online information about file 
transfer when you use the TSO HELP 
command. 


By the End of This Chapter 


You learn how to use the sample application programs to: 


@ Copy a host screen image to your IBM Personal Com- 
puter (screen capture) 


@ Copy a host CMS file or TSO data set to your IBM Personal 
Computer (file transfer) 


e Copy a personal computer DOS file to CMS or TSO (file 
transfer). 
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Preparing for Data Transfer 


You must prepare for data transfer before you can use the 
supplied sample programs to do screen capture and file transfer. 
The following steps outline what to do: 


1. 


Customize the control unit. 


Both screen capture and file transfer require customization 
of the IBM 3274 Control Unit for the IBM 3270 Personal 
Computer Attachment. Your system programmer takes 
responsibility for this step. 


Look in the left side of the operator information area 
(OIA) to see what type of control unit your display station 
is attached to. Try to match one of the symbols below: 


Symbol Meaning 


or (4}2 18M 3274 Control Unit 
[6 }4 or [o}8 IBM 3276 Control Unit 


Display Station 


ES opi IBM Integrated Display Adapter 


If your display station is not attached to an IBM 3274 
Control Unit, you cannot do screen capture or file transfer. 


To check whether the 3274 is customized, type OST 
while in personal computer mode. (Make sure the diskette 
in the default drive contains HOST.EXE, which is supplied 
on the Customization diskette, so that HOST can run.) 
Two copyrights appear on the screen, and then the screen 
switches to host computer mode. If this does not happen, 
see Appendix E and the JBM 3274 Control Unit Planning, 
Setup, and Customizing Guide, GA27-2824, for customiza- 
tion information. 
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2. Copy HOST.EXE to your personal computer application 
disk. 


HOST.EXE, the IBM Personal Computer sample application 
program for both screen capture and file transfer, is sup- 
plied on the IBM Personal Computer Attachment Option 
Customization diskette with this book. For convenience, 
you might copy HOST.EXE onto your daily application 
disk. (See the procedure in Chapter 3 for preparing an 
application disk if you do not have one.) 


3. Upload the CMS or TSO host sample application programs. 


The host sample file transfer application programs included 
on the diskette must be sent to the host to run. (Remem- 
ber, the host does not need a screen capture application 
program.) Since this step is time-consuming, you should 
send these application programs to the host once. Then 
users share the programs by: 


e Distribution over the host network to another system 
e Acommon shared host storage unit 

e A private host storage unit. 

To check whether the application programs are already 
uploaded, type in a host list command to see whether the 
CMS or TSO files listed in Table 5-1 are in your host. Refer 
to Appendix E for uploading directions. 

Note for TSO Users: Before you can transfer files, you 


must allocate DD (PCXFPROF) to point to the 
PCXFER.PROFILE data set. 


5-8 Data Transfer 


Screen Capture: Transferring a Screen to 
IBM Personal Computer with Sample 
Application Program 
Screen capture copies your host screen image to your personal 
computer printer, diskette, or fixed disk. With screen capture, 
you keep a permanent record of any host screen image. 
By using screen capture, you avoid waiting for output from 
busy 3270 printers or from busy host printers. If an IBM 
Personal Computer printer is attached to your system unit, you 
can copy your screen image immediately. 


Output Formats and Output Devices 


For screen capture, you can choose an output format and an 
output device, as follows: 


Output Format Available Output Devices 


Edit Format (default) Personal computer printer 
(default) 


Personal computer diskette 

Personal computer fixed disk 
Unformatted Personal computer diskette 

Personal computer fixed disk 


Edit Format, the default output format, is what you see on the 
screen. 


Edit Format defaults to output with headers and trailers. A 
header is an additional line at the beginning of the screen image, 
and a trailer is an additional line at the end of the screen image. 
The header and the trailer separate screen captures and provide 
a time stamp. 


The default output device is the printer. 
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Unformatted output is simply a copy of the display station’s 
buffers, which store information in machine code. The diskette 
and the fixed disk are the available output devices. 


Two types of buffer can be captured: 


@ The 3278/3279 Regeneration Screen Buffer with 3278/ 
3279 character codes and basic field attributes 


e The Extended Attribute Buffer (EAB) with 3278/3279 
extended character attribute codes (requires the /E option). 


The Programmed Symbol Set (PSS) buffers cannot be captured. 


Refer to Appendix F for translation tables and screen capture 
output formats. 


The HOST Sample Application Command Options 


Now that you know what screen capture output formats are 
available, you learn how to code your choices in the HOST 
command. Then you can capture a screen. Figure 5-1 shows 
the HOST command syntax: 


Figure 5-1. HOST Command Syntax 
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Table 5-2. HOST Command Options 


target-filespec You substitute a standard DOS 
filespec (the file you wish to 
write to). The filespec might 
take this form: [drive:] [pathN] 
filename [.exit]. If you omit the 
filespec, /U and./E are ignored, 
and Edit Format results. 


Sends the screen capture an 
unformatted output to the 
target-filespec. 


Captures the extended attribute 
buffer as well as the regeneration 


(screen) buffer. If you omit /U, 
the output defaults to Edit For- 
mat, and /E is ignored. 


Omits headers and trailers in 
Edit Format output. 


Provides a TRACE of the 
structured fields sent and is 
received by the personal 
computer HOST.EXE program. 
/T is valid for any format and 
output device. The TRACE 
output always appears on the 
personal computer mode display. 


Data Transfer 5-11 


How to Capture a Screen 


Follow the procedure in Table 5-3 to complete a screen capture. 


Table 5-3. Procedure for Screen Capture 


User Action Computer Response 


Type HOST [options] | The display station switches to 
host computer mode. 
Press ENTER. 


(Skip this step if 
HOST.EXE already 
is running.) 


[] —> CJ 993s 
displayed on the right of the 
operator information area. 


Log on to your CMS 
or TSO host. (Skip 
this step if you have 
already logged on.) 


Display the screen 
you want to capture. 


Press the Print Screen | The screen image is sent to the 
key: personal computer printer, 


[J] — J diskette, or fixed disk. 


[) 99 is 
displayed on the right of the 
operator information area 
while the screen is captured. 
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Table 5-3. 


Procedure for Screen Capture 


(continued ) 


User Action 


If you press the print 
screen key again while 
a screen is captured, 
the new screen 
remains pending. 


If you want to termin- 
ate a pending screen 
capture, press DEV 
CNCL (ALT + 

RESET on most 
keyboards). A screen 
capture already print- 
ing cannot be 
terminated. 


If you do not need any 
more screen captures, 
want to terminate 
HOST.EXE, and are in 
host computer mode: 


Hold ALT and press 
the Insert (4) key 


or 
Hold ALT and press 


PAI (for a text 
keyboard). 


Computer Response 


[L]) — [) & is 
displayed on the left of the 
operator information area until 
the current screen is captured. 
Then,{ ] ——> @ is again 
displayed on the right of the 
operator information area. 


[) —~> (J) * 
disappears from the left of the 
operator information area. 


The display switches to personal 
computer mode. 
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Table 5-3. Procedure for Screen Capture 
(continued ) 


Then, press ATTN HOST.EXE completes processing. 


LD oo no ne right of the 
operator information area in host 
computer mode. 


Screen Capture Error Messages 


e If you see error messages during screen capture, follow the 
Problem Determination Procedures in Chapter 6. 


e If you see 2%% in the operator information area, your 
3274 Control Unit may not be customized or your data 
transfer path may have problems. See your supervisor or 
system programmer. 


e If you see NY 69 in the operator information area, your 
display may be attached to a 3276 Control Unit, which 
does not support data transfer. See your supervisor or 
system programmer. 


e Ifnothing happens, and I4 or [2 is displayed in the left 
of the operator information area, your display is attached 
to an integrated display adapter (IDA). The IDA does 
not support data transfer functions for the IBM 3270 
Personal Computer Attachment. See your supervisor or 
system programmer. 
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File Transfer: Transferring Hles between 
Host and Personal Computer with 
Sample Application Programs 


You can transfer a copy of a file from your personal computer 
to your host or from your host to your personal computer. 


Reasons for Using File Transfer 


Both the host computer and the personal computer have 
advantages and disadvantages in completing certain tasks. 

As a user of the IBM 3270 personal computer attachment, 
you can choose the machine (personal computer or host) that 
best performs your task. : 


e = Flexibility 


You can continue working on the personal computer when 
the host is not available. When the host is available again, 
you can transfer the file you have been working on in 
personal computer mode to the host. 


e Printing 


You may have both personal computer printers and high- 
speed host printers available to you. The host printers 
print at a much higher speed than the personal computer 
printers, but the personal computer printers may have a 
quicker turnaround of jobs. The host printers may also 
have a higher quality printout than the personal computer 
printers. By weighing these tradeoffs, you can choose the 
best printer to match your task and transfer your file to the 
appropriate computer. 


e Backup 
You can Keep backup copies of personal computer files on 
your host system. Likewise, personal computer diskettes 


can store backup copies of sensitive host files or data sets 
for security. 
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Long Distance 


You can transfer files from one personal computer to 
another personal computer over your host network to save 
time when exchanging diskettes is inconvenient (because of 
long distance, for example). 


Merging Files 


You can merge data from host files and from personal 
computer files. : 


Guidelines for File Transfer 


Follow the guidelines below before you transfer a file. 


- Personal Computer 


Only files that are organized under DOS can be transferred 
with the sample application programs. The JBM Personal 
Computer EasyWriter Version 1.0 files CANNOT be 
transferred. 


Host Computer 


Only CMS files or TSO data sets can be transferred with the 
sample application programs. 


File Sizes 


The target computer’s available storage capacity can limit 
file size for file transfer. For example, if you transfer a file 
from the host to a personal computer diskette, make sure 
the file will fit on the diskette. File transfer does not allow 
you to span volumes. Likewise, do not transfer from the 
personal computer to the host a file that is too large for the 
available host storage device. 
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@ Methods 
From host computer mode you can do file transfer: 
— Froma menu 
— Asacommand. 


You should use the menu until you understand the file 
transfer process well. With the command format, you may 
use some options not available from the menu. 


e Changing Command Options 


Once you transfer files using the command method, many 
options are available. If you find that you need to change 
the same options for most of the files you transfer, you 
might wish to change the PROFILE PCXFER file or data 
set. 


In addition, PROFILE PXCFER might not contain unique 
host filetypes and descriptive qualifiers, or filetypes and 
descriptive qualifiers that are spelled differently by your 
host. You will need to change PROFILE PCXFER to 
reflect your host’s filetype or descriptive qualifier conven- 
tions, or your files might be transferred in a different 
format from that you intended. 


You can change PROFILE PCXFER easily, but you must 
first master the “File Transfer” and “Syntax for PROFILE 
PCXFER” sections of this chapter. 
Transferring a File with a Menu 
Your system needs the Interactive System Productivity Facility 
(ISPF) for support of the menu panels. Usually, your system 
programmer sets up ISPF. Refer to Appendix E for more 


information. 


Follow Table 5-4 to complete a menu-driven file transfer. 
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Table 5-4. Procedure for File Transfer 
with a Menu 


Type HOST The display station 
switches to host computer 
and press ENTER mode. 


(Skip this step if 
HOST.EXE already is 
running. 


|] —> [J 993s 
displayed in the operator 
information area. 


Log on to your CMS or 
TSO host. (Skip this step 
if you have already logged 
on.) 


Type PCXFER A menu panel is displayed on 
your screen. (An error mes- 

and press ENTER sage is displayed if you do 
not have access to ISPF.) 


Complete the menu: 


1. Enter values into blank 
fields (= =>). 


. Type over any default 
values you wish to 
change. 


. Press ENTER. 
Status messages are displayed 
on your screen as the file 
transfer occurs. 
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Table 5-4. Procedure for File Transfer 
with a Menu (continued ) 


User Action Computer Response 


If you want to cancel the 
file transfer, press 


PF3 or PF15 PCXFER is terminated. 
The display returns to the 
menu. 


If you see x-f, press 
RESET and try again. 


If you do not need any The PCXFER menu is 
more files transferred, completed. 
exit the menu by pressing 


PF3 or PFIS 


If you want to terminate The display switches to 


HOST.EXE and are in personal computer mode. 
host computer mode: 


Hold ALT and press the 
Insert key (#) 


Or 


Hold ALT and press 
PAI (for a text 
keyboard). 


Then, press ATTN HOST .EXE completes 
| processing. 


[} — > [] 99 


disappears from the right of 
the operator information area 
in host computer mode. 
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Transferring a File with Commands 


Follow Table 5-5 to complete a file transfer without a menu. You 
can find more information about coding the PCXFER command 
options in CMS and TSO in the sections that follow. 


Table 5-5. Procedure for File Transfer 
with Commands 


Type HOST The display station switches to 
host computer mode 


and press ENTER 


(Skip this step if 
HOST.EXE already is 
running.) 


a ea & 99 is displayed 


in the operator information area. 


Log on to your CMS or 
TSO host. (Skip this step 
if you have already 
logged on.) 


If you are a TSO user, 
you must allocate DD 
(PCXFPROF) to point 

to the PCXFER.PROFILE 
data set before running 
PCXFER. (Skip this 

step if you have already 
allocated DD.) 
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Table 5-5. Procedure for File Transfer 
with Commands (continued ) 


For CMS, enter For both CMS and TSO: 


PCXFER cms-file-id 1. Status messages appear as the 
TO | FROM file transfer progresses. 
personal-computer-filespec 7 

[(options] 2. PCXFER completes processing. 


For TSO, enter 


PCXFER DSNAME 
(TSO-data-set-name) 

TO | FROM FILESPEC 
(personal-computer-filespec) 
[options] 


To terminate PCXFER PCXFER is terminated. 
during a file transfer, press 


PF3 or PF15. 


If you see x-f, press 
RESET and try again. 
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Table 5-5. Procedure for File Transfer 
with Commands (continued) 


If you want to terminate The display switches to personal 
HOST.EXE and are in computer mode. 
host computer mode: 


Hold ALT and press 
the Insert (@) key 


OT 


Hold ALT and press 
PA1 (for a text 
keyboard). 


Then, press ATTN HOST.EXE completes processing. 


O—> U 99 

disappears from the right of the 
operator information area in host 
computer mode. 
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PCXFER Command Options for CMS 


The CMS PCXFER command transfers files from CMS to your 
personal computer or from your personal computer to CMS. 
Each time you enter the CMS PCXFER command, you must 
supply the required fields: 


e cms-file-id 
e TO|!FROM 
@ personal-computer-filespec 


However, several optional fields help you tailor the file transfer 
to your special needs. Figure 5-2 outlines the complete 
PCXFER command, including options. 


PCXFER cms-file-id 
TO |FROM 
personal computer-filespec [( 
[NEWfile | REPlace] 
[EDIT |BAS | VAR | LIST | UNFM] 


[TRAN[(fn[ft [fm] ])] | NOTRAN] 
[LRecl nnnnn| 
[RECFM F | V] 
[UNNum] [)]}] 


Figure 5-2. CMS PCXFER Command Syntax 
Required Fields 
cms-file-id 


You type in the CMS filename and filetype. The filemode is 
optional and defaults to Al if you omit it. 
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TO | FROM 


TO copies your CMS file to your personal computer target file. 
FROM copies a CMS target file from your personal computer 
file. 


personal computer filespec 


You supply a valid IBM Personal Computer DOS file specifica- 
tion (for example, A:[path\] TEST.FIL or LPT1). You can use 
the PATH parameter as a valid part of the filespec. (Refer to 
the JBM Personal Computer DOS manual.) 


Optional Fields 
( . 


A left parenthesis is required if you are specifying any of the 
following optional fields. 


NEW | REP 


You use REPlace to replace an existing copy of the file with 
the copy of the file being transferred. Since NEWfile is the 
default value for creating the first copy, file transfer halts if the 
target file already exists. 


UNNum 


UNNum removes sequence numbers from a CMS file when it is 
transferred to a personal computer file. Otherwise, sequence 
numbers are not removed. UNNum applies only for files trans- 
ferred from CMS to the personal computer. 


The sequence numbers are removed from the last 8 characters of 
each record if the CMS file has a fixed (F) RECFM. The 
Sequence numbers are removed from the first 8 characters of 
each record if the CMS file has a variable (V) RECFM. 
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Note: The remainder of the optional fields default to values deter- 
mined by the CMS filetype. These default values are found in the 
PROFILE PCXFER file. You choose one of the options below only 
to override the values determined by PROFILE PCXFER. The 
PROFILE PCXFER syntax is described under “Syntax for PROFILE 
PCXFER and PCXFER.PROFILE”’. Use that section to change any 
defaults in PROFILE PCXFER. | 


EDIT | BAS | VAR | LIST | UNFM 


EDIT, BAS, VAR, LIST, and UNFM are personal computer file for- 
mats. See the heading “A Guide to Choosing the Personal Computer 
File Formats,” at the end of this chapter, and Appendix F to choose 
one of these options. 


TRAN | NOTRAN 


TRAN translates each character from the source file to the target file 
(from personal computer ASCII to host EBCDIC, or vice versa). See 
Appendix F for these translation tables. NOTRAN opts for no 
translation. 


You can use the (fn ft fm) option of TRAN to change the way 
PCXFER translates a file. (fn ft fm) identifies a file that uses modi- 
fications to the translation table. Refer to the translation tables in 
Appendix F for a description of what should be in this file identified 
by (fn ft fm). If fn, ft, and fm are not specified, the default transla- 
tion tables found in Appendix F are used. If ft is not specified, the 
default is TRAN. 


LRecl nnnnn 


LRecl specifies the logical record length of the CMS file. LRecl 
applies only for file transfer from the personal computer to CMS. 


RECFM F | V 
RECFM specifies the record format of the CMS file. The format 


contains fixed (F) or variable (V) length records. RECFM applies 
only for file transfer from the personal computer to CMS. 
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An Example 
Figure 5-3 shows an example of how the PCXFER command works. 


You can try out a similar example on your system. 


EXAMPLE 


Suppose you type in: 
pexfer memol script to memol.scr (rep 


The result: 


1. PCXFER transfers the CMS file ““memol script” to the IBM 


Personal Computer. 


If “‘memol scr” already exists on the diskette or fixed disk, 
PCXFER will replace “memol scr’ with “memol script” 
from CMS. 


If ““memol.scr’’ does not exist on the diskette or fixed disk, 
PCXFER creates a new file ““memol.scr” from the CMS file 
“‘memol script’’. 


Figure 5-3. An Example of File Transfer for CMS 
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PCXFER Command Options for TSO 


The TSO PCXFER command transfers data sets from the personal 
computer to TSO or from TSO to the personal computer. Each time 
you enter the TSO PCXFER command, you must supply the required 
fields: 


e DSName(tso-data-set-name) 
e TO|FROM 
e FILEspec(personal-computer-filespec) 


Several optional fields, however, help you tailor the file transfer to 
your special needs. Figure 5-4 outlines the complete PCXFER com- 
mand, including options. 


PCXFER DSName(tso-data-set-name) 
TO | FROM 
FILEspec(personal-computer-filespec) 
[NEW | MOD] 
[EDIT | BAS | VAR | LIST | UNFM] 
[TRAN | NOTRAN | TRANS(dsname)] 
[RECFM(F | FB | FA | FM | FBA|FBM|V|VB|VA 

| VBA | VBM | U)] 

[VOLume(tso-volume-identifier) | 
[PASSword(tso-data-set-password) | 
[LRECL(nnnnn)| 
[BLKSIZE(nnnnn)| 
[SPACE(nn)] 
[SPACE2(nn) | 
[TRACKS | CYLinder] 
[DIR(nn)] 
[UNNum ] 


Figure 5-4. TSO PCXFER Command Syntax 
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Required Fields 


DSName(tso-data-set-name) 


You must supply a valid TSO data set name. Refer to the JBM 
System/370 and 4300 Processors Bibliography, GC20-0111, for 
more information. 


TO | FROM 


TO copies your TSO data set to your personal computer data set. 
FROM copies a TSO data set from your personal computer data 
Set. 


FILEspec(personal-computer-filespec) 


You supply a valid IBM Personal Computer DOS file specification 
(for example, A:[path\] TEST.FIL or LPT1). You can use the 
PATH parameter as a valid part of the filespec. (Refer to the JBM 
Personal Computer DOS manual.) 


Optional Fields 
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NEW | MOD 


You use MOD to replace an existing copy of the data set with the 
copy of the data set being transferred. Since NEW is the default value 
for creating the first copy, file transfer halts if the target data set 
already exists. 


UNNum 


UNNum removes sequence numbers from a TSO data set when it is 
transferred to a personal computer data set. Otherwise, sequence 
numbers are not removed. UNNum applies only for data sets trans- 
ferred from TSO to the personal computer. 


The sequence numbers are removed from the last 8 characters of each 
record if the TSO data set has a fixed (F) RECFM. The sequence 
numbers are removed from the first 8 characters of each record if the 
TSO data set has a variable (V) RECFM. 
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VOLUME, SPACE, SPACE2, TRACKS, CYLINDERS, DIR 


You use these options to create a new data set on TSO. These options 
are the same as the options on the TSO ALLOCATE and ATTRIB 
commands. However, SPACE specifies the primary allocation amount, 
and SPACE2 specifies the secondary allocation amount. 


Note: The remainder of the optional fields default to values deter- 
mined by the TSO descriptive qualifier. These default values are 
found in the PCXFER.PROFILE data set. You choose one of the 
options below only to override the values determined by 
PCXFER.PROFILE. The PCXFER.PROFILE syntax is described 
under “‘Syntax for PROFILE PCXFER and PCXFER.PROFILE”’. 
Use that section to change any defaults in PCXFER.PROFILE. 


EDIT | BAS | VAR | LIST | UNFM 


EDIT, BAS, VAR, LIST, and UNFM are personal computer file 
formats. See the heading ““A Guide to Choosing the Personal Com- 
puter File Formats,” at the end of this chapter, and Appendix F 

to choose one of these options. 


TRAN | NOTRAN | TRAN(dsname) 


TRAN translates each character from the source data set to the tar- 
get data set (from personal computer ASCII to host EBCDIC, or vice 
versa). See Appendix F for these translation tables. NOTRAN opts 
for no translation. 


You can use the (dsname) option of TRAN to change the way 
PCXFER translates a data set. (dsname) identifies a data set that 
contains modifications to the translation table. Refer to the trans- 
lation tables in Appendix F for a description of what should be in this 
data set identified by (dsname). If (dsname) is not specified, the 
default translation tables found in Appendix F are used. 


PASSword(tso-data-set-password) 
PASSWORD is used to specify TSO read or write passwords. If not 
specified, TSO prompts you for these passwords. File transfer will 


not protect the replaced data set with a password if the password was 
not specified. 
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RECFM, LRECL, BLKSIZE 


You use these options to create a new data set on TSO. 


Syntax for PROFILE PCXFER and 
PCXFER.PROFILE 


Your host uses the PROFILE entry to find out what default 
options apply to the files or data sets you transfer if you do not 
specify the options in CMS or TSO. PROFILE PCXFER lists 
the filetype or descriptive qualifier and the corresponding logical 
record length (LRecl), record format (RECFM), translation 
option (TRAN or NOTRAN), and personal computer file for- 
mat (EDIT, BAS, VAR, LIST, UNFM). PCXFER will choose 
default options unless you override it by putting the options you 
desire in the PCXFER command. 


You will want to make sure that the default options specified in 
PROFILE PCXFER are the ones you need and want for file 
transfer. (This discussion also applies to PCXFER.PROFILE 
for TSO.) You can do this in three ways: 


1. You should make sure that the filetypes or descriptive 
qualifiers listed in PROFILE PCXFER match the ones 
you conventionally use on your host. 


For example, in CMS, PROFILE PCXFER might contain 
the filetype ASSEMBLE to indicate an assembly language 
file. Your system might use the filetype ASM or SYSIN to 
indicate an assembly language file. Unless you change 
(using your host editor) the ASSEMBLE to ASM or SYSIN, 
PCXFER will transfer an ASM or SYSIN file under the 
options corresponding to ‘*’. ‘*’ is used for any filetypes 
not listed in PROFILE PCXFER. 


2. Besides changing filetypes to your host conventional file- 
types, you can add new filetypes or ones unique to your 
host to PROFILE PCXFER. Again, you simply change 
PROFILE PCXFER with your host editor. 
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3. You can also change the options corresponding to the file- 
types in PROFILE PCXFER. 


For instance, if you always want the TRAN option with a 
SCRIPT file, you should make sure PROFILE PCXFER lists 
TRAN as the default option. Otherwise, you will need 

to type in the TRAN option every time you enter the 
PCXFER command. 


Suppose your host printer will not be available for some 
time, because of repair, and you have many short memos 

in SCRIPT to print. You might choose to change the per- 
sonal computer file format default for SCRIPT filetypes 
from EDIT to LIST. If you process the file with script in 
your host, you can transfer the file to the IBM Personal 
Computer. Then, the personal computer printer will print 
out the actual memo (LIST format) and not the memo with- 
out the printer carriage control characters (EDIT format). 


To look at or change PROFILE PCXFER in CMS, locate 
PROFILE PCXFER AI in your host editor. 


CMS PROFILE PCXFER Syntax 


Figure 5-5 outlines the fomat for entries in PROFILE PCXFER. 


cms-filetype | * 
RECFM F | RECFM V 


LRECL N fn[ft[fm] ] 
TRAN | NOTRAN 
EDIT | UNFM | VAR | BAS | LIST 


Figure 5-5. CMS PROFILE PCXFER Syntax 


Data Transfer 5-31 


Field Definitions 


cms-filetype 


You supply a user-specified filetype. 


* 


Use * for filetypes that do not match a statement in your profile. 
The * specifies that this profile statement applies to any file being 
copied to or from CMS witha filetype for which there is no profile 
statement. Suppose, for example, you transferred a personal 
computer file to CMS that has a filetype of TREE. If your pro- 
file did not have a statement with a filetype of TREE, the follow- 
ing statement in the IBM-supplied profile would apply to the 
CMS file: * recfm v lrecl 65535 notran unfm. 


RECFM 


The record format, or RECFM, can use fixed-length records (F) 
or variable-length records (V). 


LRECL n 


LRECL specifies the logical record length. The number of char- 
acters in each record, n, can be a maximum value of 65535. 


TRAN 


TRAN translates characters between ASCII and EBCDIC as the 
file is copied. (The Personal Computer uses ASCII code to repre- 
sent characters; the host uses EBCDIC to represent characters.) 
You use TRAN when you copy a file that you will need to read, 
edit, or list on the screen or to print on the printer. 


Tables F-8 and F-9 (in Appendix F) respectively show the trans- 
lation values from ASCII to EBCDIC and from EBCDIC to ASCII. 
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You can use the (fn ft fm) option of TRAN to change the way 
PCXFER translates a file. (fn ft fm) identifies a file that uses 
modifications to the translation table. Refer to the translation 
tables in Appendix F for a description of what should be in this 
file identified by (fn ft fm). If fn, ft, and fm are not specified, 
the default translation tables found in Appendix F are used. If ft 
is not specified, the default is TRAN. 


NOTRAN 


NOTRAN does not translate characters between ASCII and 
EBCDIC as the file is copied. Use NOTRAN for files you do not 
need to display, such as files containing executable code or binary 
data. 


Personal Computer File Format Descriptions 


EDIT 


The Personal Computer file transferred is in EDIT format. If you 
transfer a file from the Personal Computer, make sure that the 
Personal Computer file you transfer is in EDIT format. If you 
transfer a file to the Personal Computer, the file created at the 
Personal Computer will be in EDIT format. Refer to “A Guide to 
Choosing Personal Computer File Formats,” at the end of this 
chapter, for more information. 


UNFM 


Files are sent as is. The Personal Computer file being transferred 
is in UNFM format. Refer to “A Guide to Choosing Personal 
Computer File Formats,” at the end of this chapter, for more 
information. 


VAR 


The Personal Computer file being transferred is in VAR format. 
If you transfer a file from the Personal Computer, make sure that 
the Personal Computer file you transfer is in VAR format. If you 
transfer a file to the Personal Computer, the file created at the 
Personal Computer is in VAR format. Refer to ‘“‘A Guide to 
Choosing Personal Computer File Formats,”’ at the end of this 
chapter, for more information. 
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e BAS 


The format of a BAS file is determined by the first byte of the 
file. | 


If the first byte of the file is X‘FF’ or X‘FE’, the Personal Com- 
puter file is in UNFM format. These are the values that BASIC 
uses to identify internal format and protected format BAS files 
on the Personal Computer. 


If the first byte of the file is not X‘FF’ or X‘FE’, the Personal 
Computer file is in EDIT format. You can generate EDIT file for- 
mats from BASIC by saving your BASIC program with the ASCII 
option. 


e . LIST 


The file is a listing file with printer control information in it. If 
you transfer a file from the Personal Computer, PCXFER 
reformats the file for the host printer. If you transfer a file to the 
Personal Computer, PCXFER reformats the file for the IBM Per- 
sonal Computer Printer. Refer to “A Guide to Choosing Personal 
Computer File Formats,” at the end of this chapter, for more 
information. 


TSO PCXFER.PROFILE Syntax 


Figure 5-6 outlines the format for entries in PCXFER. PROFILE. 


tso-descriptive-qualifier | * 

DSORG PS | PO 

RECFM (F | FB | FA | FM | FBA | FBM | V | VB| VA | VM 
| VBA | VBM | U) 


LRECL n 

BLKSIZE n 

TRAN | NOTRAN | TRANS(dsname) 
EDIT | UNFM | VAR | BAS | LIST 


Figure 5-6. TSO PCXFER.PROFILE Syntax 


5-34 Data Transfer 


Field Definitions 

e tso-descriptive-qualifier 
The tso descriptive qualifier is the last qualifier of a user-specified 
TSO data set name. For example, in the TSO data-set name 
ONE.TWO.THREE, THREE is the descriptive qualifier. You 
supply your own descriptive qualifier. 

e@ * 
Use * for data set types that do not match a statement in your 
profile. * specifies that this profile statement applies to any data 
set being copied to or from TSO with a data set name for which 
there is no profile statement. 


e DSORG 


The data set organization, DSORG, can be partitioned organiza- 
tion (PO) or physical sequential organization (PS). 


e RECFM 


RECFM represents the record format and the characteristics of 
the data set. 


— A 


The data set records contain American National Standards 
Institute (ANSI) control characters. 


— B 

The data set contains blocked records. 
— F 

The data set contains fixed-length records. 
— M 


The records in the data set contain machine code control 
characters. 
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— U 
The data set contains undefined-length records. 
— Vv 
The data set contains variable-length records. 
e LRECLn 


LRECL n specifies logical record length. The number of char- 
acters in each record, n, can be a maximum value of 32756. 


e BLKSIZEn 


. BLKSIZE n specifies block size, where n is the length in bytes of 
a data block. The maximum block size is 32760. 


e TRAN 


TRAN translates characters between ASCII and EBCDIC as the 
data set is copied. (The personal computer uses ASCII code to 
represent characters; the host uses EBCDIC to represent char- 
acters.) You use TRAN when you copy a data set that you will 
need to read, edit, or list on the screen or to print on the printer. 


Tables F-8 and F-9 (in Appendix F) respectively show the trans- 
lation values from ASCII to EBCDIC and from EBCDIC to ASCII. 


e TRANS(dsname) 


You can use the (dsname) option of TRANS to change the way 
PCXFER translates a data set. (dsname) identifies a data set 
that contains modifications to the translation table. Refer to the 
translation tables in Appendix F for a description of what should 
be in this data set identified by (dsname). If (dsname) is not 
specified, the default translation tables found in Appendix F are 
used. 
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NOTRAN 


NOTRAN does not translate characters between ASCII and 
EBCDIC as the data set is copied. Use NOTRAN for data sets 
you do not need to read, such as data sets containing executable 
code or real numbers. 


Personal Computer File Format Descriptions 


EDIT 


The Personal Computer file transferred is in EDIT format. If you 
transfer a file from the Personal Computer, make sure that the 
Personal Computer file you transfer is in EDIT format. If you 
transfer a file to the Personal Computer, the file created at the 
Personal Computer will be in EDIT format. Refer to ““A Guide 
to Choosing Personal Computer File Formats,” at the end of this 
chapter, for more information. 


UNFM 


Files are sent as is. The Personal Computer file being transferred 
is in UNFM format. Refer to “A Guide to Choosing Personal 
Computer File Formats,” at the end of this chapter, for more 
information. 


VAR 


The Personal Computer file being transferred is in VAR format. 
If you transfer a file from the Personal Computer, make sure that 
the Personal Computer file you transfer is in VAR format. If you 
transfer a file to the Personal Computer, the file created at the 
Personal Computer is in VAR format. Refer to “A Guide to 
Choosing Personal Computer File Formats,” at the end of this 
chapter, for more information. 


BAS 


The format of a BAS file is determined by the first byte of the 
file. 
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If the first byte of the file is X‘FF’ or X‘FE’, the Personal Com- 
puter file is in UNFM format. These are the values that BASIC 

uses to identify internal format and protected format BAS files 
on the Personal Computer. | 


If the first byte of the file is not X‘FF’ or X‘FE’, the Personal 
Computer file is in EDIT format. You can generate EDIT file 
formats from BASIC by saving your BASIC program with the 
ASCII option. 


e LIST 


The file is a listing file with printer control information in it. If 
you transfer a file from the Personal Computer, PCXFER refor- 
mats the file for the host printer. If you transfer a file to the 

- Personal Computer, PCXFER reformats the file for the IBM Per- 
sonal Computer Printer. Refer to “A Guide to Choosing Personal 
Computer File Formats,” at the end of this chapter, for more 
information. 


A Guide to Choosing Personal Computer File 
Formats 
You can choose from five Personal Computer file formats when you 
enter your PCXFER command in CMS or TSO. (See Table 5-6.) If 
you don’t choose a format, the file transfer program defaults to a 


value provided by the PROFILE PCXFER file or PROFILE.PCXFER 
data set. 


Your choice of a Personal Computer file format depends on your task. 
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Table 5-6. A Guide to Personal Computer 
File Formats 


| Format Applications Use and Examples 


Edlin or Visicalc Use EDIT format if you 
want to edit, display, or list 
in both the personal com- 
puter and host computer 
modes. 

Examples: 


1. Program Source Files 
(ASSEMBLER, 
PASCAL, PL/1) 


Editable Data Files 
(Visicalc DIF format 
files) 


BASIC Editor or If you save the file with the 

BASICA Editor ASCII option, the file 
transfers in EDIT format. 
You can edit the file on 
CMS or TSO. 


If you save the file without 
an option or with the 
Protected option, the file 
transfers in UNFM format. 
The file is not usable on 
CMS or TSO. 


CMS file or TSO Use VAR format for any 

file transferred as noneditable CMS or TSO 

VAR format file file with variable-length or 
undefined records. VAR 
keeps the record format, so 
the transferred file is an 
exact copy of the original. 


Examples: CMS or TSO 
load modules. 
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Table 5-6. A Guide to Personal Computer 
File Formats (continued ) 


Applications Use and Examples 


Output listing of: Use LIST format for files 
Assembler with printer control 
PASCAL Compiler characters. The file 
BASIC Compiler transfer program converts 
COBOL Compiler ASCII printer control 
FORTRAN characters to System/370 
Compiler printer machine control 
characters, and vice versa. 


A personal computer listing 
file sent to TSO should 
have RECFM M to indicate 
machine-readable control 
characters. 


Visicalc, BASIC Use UNFM format for files 
program, PASCAL that do not fit in any of the 
program above categories. 


Examples: Visicalc output 
(such as TEST.VC) 
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Chapter 6. Problem Determination 


IBM Service Information for the IBM 3270 
Personal Computer Attachment Option 


To obtain IBM service during the warranty period and after the expira- 
tion of warranty, use the Problem Determination Procedures provided 
in this chapter to determine which machine type is defective. 


e If the problem isin the 3278 or 3279 display, or in the 3278/3279 
keyboard, call your normal service number. 


e Ifthe problem isin the IBM Personal Computer, the IBM Personal 
Computer 3270 Attachment Option, or any other IBM Personal 
Computer option (for example, 5152 Printer), call the National 
Support Center as follows: 

If you are within the continental United States or Puerto Rico, 
call toll-free 1 (800) 428-2569. In Hawaii, Alaska, and Guam, 
call collect (312) 986-7451. 

Introduction to Problem Determination 

This chapter contains problem determination procedures to help you 

isolate and resolve operational and system failures. These problem 

determination procedures direct you to: 

e@ Perform certain checks 

@ Make a series of observations 

e Respond as indicated by the No-Yes results of those observations. 

By following the directions in the problem determination procedures, 


you can determine whether service is needed or what action to take 
to make your system operational again. 


Problem Determination 6-1 


The general procedure is as follows: 


1. 


Use the Symptom Index (Table 6-1) to locate the problem type 
or symptom that most accurately describes your problem. 


Follow the action recommended for your symptom. Always 
start a procedure with all cables connected and the rear Test 
switch set to Normal. 


If you complete the recommended action without isolating the 
problem, use the Symptom Index to locate another problem 
type or symptom that also describes your problem. 


If you cannot find an appropriate entry in the Symptom Index, 
start at Problem Determination Procedure 1 , Undetermined 


. Failures. 


Whichever path you are directed to take in a problem determina- 
tion procedure, follow it until the procedure indicates the defec- 
tive unit or tells you to return to user operation. 


Users with hardware service experience should refer to Appen- 
dix H for advanced diagnostic information. 


When directed by a problem determination procedure to return the 
system unit for repair, include: 


The distribution box 
All cables that connect the system unit to the display 
The system unit power cord 


All IBM cards within that unit. DO NOT include non-IBM 
cards and cables. 


Remember, whenever you return the system unit for repair, you 
can hook up the keyboard cable to the display and operate in host 
computer mode until the repaired system unit is returned. 


Note: Refer to Appendix J for information on how to repack com- 
ponents for shipping or relocation. 
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Diagnostic Aids 


In order to run the IBM Personal Computer 3270 Adapter Diagnostics 
**3270DIAG”’, 3270DIAG.EXE must be co-resident with 
3270ATT.EXE (See step 3 under “Customizing Your System Disk”’ 
in Chapter 3.) 


When you are directed to run the IBM Personal Computer Diagnostics 
(from the JBM Personal Computer Guide to Operations) or the 
Advanced Diagnostics (from the JBM Personal Computer Hardware 
Maintenance and Service manual), the diagnostics must be at Version 


1.02 or later. The version number is on the IBM Personal Computer 
Diagnostics diskette label. 


Running the IBM Personal Computer Diagnostics and 
Advanced Diagnostics 


When directed to perform the IBM Personal Computer Diagnositcs, 
do the following: 


1. Set the system unit On/Off switch to Off. 


2. Ready your system disk. (This phrase means you insert your sys- 
tem diskette in drive A.) 


3. Set the system unit On/Off switch to On. Wait for initialization 
to be completed. 


4. Remove the system diskette from drive A of the system unit. 


5. Insert the IBM Personal Computer Diagnostics diskette into 
drive A of the system unit. 


6. If drive A is not the default drive, they type A:. 


7. Type COMMAND then press ENTER. 
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8. The IBM Personal Computer Diagnostics will load and execute. 
Follow the IBM Personal Computer operating Procedures given 
in Section 4, “Problem Determination,” of the JBM Personal 
Computer Guide to Operations. 

Notes: 


Since the IBM Personal Computer keyboard is not attached to 

the system unit, the keyboard section of the IBM Personal Com- 
puter Diagnostics WILL NOT run successfully. On some personal 
computer models, the diagnostics will enter the keyboard test. The 
keyboard test pattern appears on the display. If you enter the 
keyboard test, exit it by holding down the “‘n” key and pressing 
the Enter key several times. Do not attempt to perform the 
keyboard tests. 


The IBM Personal Computer 3270 Adapter does not appear in 


the list of installed devices displayed by the IBM Personal Com- 
puter diagnostic programs. If the list is otherwise correct, respond 
Y (Yes) to the question “IS THE LIST CORRECT (Y/N)?” 


System Unit Problems 


When the system unit is called out in the problem determination pro- 
cedures as the failing element, it may be helpful to do the problem 
determination again with all the nonessential adapter and memory 
cards removed. 


Intermittent IBM Personal Computer 3270 Attachment 
Option Problems 


Run the IBM Personal Computer 3270 Attachment Option Diag- 
nostics (3270DIAG.EXE) in single-pass mode for normal problem 
determination. Multipass mode should be used only to determine 
intermittent IBM Personal Computer 3270 Adapter problems. 
Problem Determination Procedure 6 includes instructions for load- 
ing and running 3270DIAG.EXE. 
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Screen Capture and Data Transfer Checkout 


Run the Data Transfer Wrap Test, Option 2, of the IBM Personal 
Computer 3270 Attachment Option Diagnostics (3270DIAG.EXE) 
for a quick verification of the 3274-to-personal-computer connection. 
Problem Determination Procedure 6 includes instructions for loading 
and running 3270DIAG.EXE. 


Symptom Index 


Use the Symptom Index (Table 6-1) to locate the problem or symp- 
tom that most accurately describes your situation. Next, follow 
directly across the chart to the problem determination procedure 
number to be used to resolve the problem. Locate the procedure in 
the following pages and perform the actions specified. If you cannot 
find an applicable problem type or symptom for your situation, start 
at Problem Determination Procedure 1 (Undetermined Failures). 


Table 6-1. Symptom Index Chart 


After power-on of system unit: Start at Procedure 2, 
ENTRY POINT 200. 
1. Incorrect or no audio response 
(anything other than a single 
short beep from the system 
unit) 


OT 


Any error message on the 
screen other than a temporary 
301 code or a 19xx code (see 
below for 19xx errors) 


Or 


Wrong or random characters, 
Or no cursor on Screen. 
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Table 6-1. Symptom Index Chart 
(continued ) 


3278 display problems: Start at Procedure 3, 
ENTRY POINT 300. 
1. Display station inoperable 


or 
Screen blank, distorted, or 
unreadable in host computer 


or personal computer mode 


3279 display problems: Start at Procedure 9, 
ENTRY POINT 900. 


1. Screen blank, distorted, 
unstable, or unreadable in host 
computer or personal computer 


mode 
or 


Wrong or random characters 
(without using the keyboard) 


or 
Wrong colors 


Keyboard problems: Start at Procedure 4, 
ENTRY POINT 400. 

Keyboard dead, characters on 

screen not as expected, or other 

key functions fail in either host 

computer or personal computer 

mode. 
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Table 6-1. Symptom Index Chart 
(continued ) 


Symptom 


19xx errors Start at Procedure 5, 
ENTRY POINT 500. 


A 19xx error code displayed 

during the IBM 3270 Personal 
Computer Attachment initialization 
(xx = number listed in Table 6-2). 


Data transfer failures: Start at Procedure 6, 
ENTRY POINT 600. 

Errors observed during screen 

capture or file transfer operations. 


Mode switch failure: Start at Procedure 7, 
ENTRY POINT 700. 
1. Display does not change from 
host computer to personal 
computer mode when the 
system unit is switched on. 


Or 


Display does not go to host 
computer mode when the 
system unit is switched off. 


Or 


Display fails to switch between 
modes when ALT and PAI (on 
text keyboards) or ALT and 
Insert (on all other keyboards) 
are pressed. 


or 
Display switches from one 


mode to the other when it 
should not. 
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Table 6-1. Symptom Index Chart 
(continued ) 


Error codes in the operator Start at Procedure 8, 
information area: ENTRY POINT 800. 


Error information in the operator 
information area in host computer 
mode. 


Printer problems: See the JBM Personal 

Computer Guide to 
Printer failure (printer attached to Operations manual. 
the system unit). 


Undetermined failures: Start at Procedure 1, 
ENTRY POINT 100. 


Symptoms not listed above. 
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Problem Determination Procedure 1: 
Undetermined Failures 


ENTRY POINT 100 


Problem determination is based on the assumption that some units of 
the system are known to be operational, or have proved to be opera- 
tional from previous problem resolution, in order to test the suspected 
defective unit. For example, to perform Problem Determination Pro- 
cedure 4: Keyboard Problems, the display device must be working 
properly if the keyboard test pattern is to be displayed and checked 
with a known good pattern. 


If you have a failure, but cannot determine the exact nature of the 
failure, sequentially perform Problem Determination Procedures 2 
through 7 for a 3278, or sequentially perform procedures 2,9, and 4 
through 7 for a 3279, until the failing element has been identified. 


If you complete procedures 2 through 7 without finding any problems, 
run the IBM Personal Computer Diagnostics. See the instructions 
under the heading “Running the IBM Personal Computer Diagnostics 
and Advanced Diagnostics.” 


Doing problem determination in this manner will ensure that you will 
not receive false error indications. 


If your control unit supports the data transfer function, it may be 
helpful to run the Data Transfer Wrap Test, Option 2, of the IBM Per- 
sonal Computer 3270 Attachment Option Diagnostics (3270DIAG) 
for a quick verification of the 3274-Control-Unit-to-personal-computer 
connection. (See “Screen Capture and Data Transfer Checkout,” in 
this chapter.) 
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Problem Determination Procedure 2: Power-On 
Self-Test (POST) 


ENTRY POINT 200 

1. Set the system unit On/Off switch to Off. 

2. Wait 5 seconds. 

3. Remove any diskette in drive A. 

4. When you switch on the system unit, the Power-On Self-Test is 


run. This usually takes from 5 to 90 seconds, depending on the 

amount of memory installed in your system. Several responses 

occur during this test. 

Notes: 

a. On some models of the 3279 color display, the screen may 
have an unstable image and multiple images. This condition 
is normal for this step. 

b. On some models of the IBM Personal Computer System Unit, 
a momentary 301 message appears on the screen. This condi- 
tion is normal for this step. | 

Note the responses: 

® Accursor appears on the screen. 


© The memory test progress messages also appear. 


® You hear one short beep. 
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e The IBM Personal Computer Basic message appears on the 
screen. 


e No other error messages are displayed. 


Set the system unit On/Off switch to On. 


Have the above responses occurred? 


No Yes—Goto ENTRY POINT 210. 

Go to ENTRY POINT 220. 

ENTRY POINT 210 

1. Set the system unit On/Off switch to Off. 

2. Wait 5 seconds. 

3. Ready the system disk. 

4. When you switch on the system unit, the Power-On Self-Test is 


run and the IBM Personal Computer 3270 Attachment Option 
initialization takes place. This usually takes from 5 to 90 seconds, 
depending on the amount of memory installed in your system. 
Several responses occur during the test. 

Notes: 


a. Onsome models of the 3279 color display, the screen image 
may be temporarily unstable and the screen may have 
multiple images. This condition is normal for this step. 

b. On some models of the IBM Personal Computer System Unit, 
a momentary 301 message appears on the screen. This condi- 
tion is normal for this step. 

Note the responses: 


e Accursor appears on the screen. 


@ The memory test progress messages also appear. 
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e You hear one short beep. 


e@ IBM Personal Computer 3270 Attachment Option appears on 
the screen. There should be only one stable image at this 
time. 


e No other error messages are displayed. 
5. Set the system unit On/Off switch to On. 
Have the above responses occurred? 


No Yes — Power-On Self-Test (POST) did not fail. Return to the 
user Operation or to the procedure that sent you here. 


220 


Was the POST failure indicated by the display of a 30] error message 
that remained on the screen? 


No Yes 


EXIT POINT 225 

Check that the keyboard pigtail lead and the keyboard 
adapter cable are properly connected. See Figure 6-4. If no 
trouble is found, have the system unit serviced. 


230 


Was the POST failure indicated as an incorrect audio response by the 
system unit? 


No Yes 
EXIT POINT 235 
Any response other than a single short beep indicates a system 
unit problem. Have the system unit serviced. 

240 

Was an error code of 19xx received? (xx = the numbers listed in 


Problem Determination Procedure 5.) 
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No Yes — Goto Problem Determination Procedure 5, 
ENTRY POINT 500. 


250 


Was the POST failure indicated by the display of any error message 
other than a temporary 301 code? (A temporary 301 error message 
is one that remains on the screen for less than 90 seconds.) 


No Yes 


EXIT POINT 255 

Display of any error message other than a temporary 301 code 
indicates the system unit is the failed element. Have the system 
unit serviced. 


260 


Was the POST failure indicated by wrong or random characters on the 
display screen or by the absence of a cursor? 


No Yes — The appearance of wrong or random characters, the 
absence of a cursor, or an unstable display indicates the 
system unit or the display station is the failed element. 
For a 3278, go to procedure 3, ENTRY POINT 300. 
For a 3279, go to procedure 9, ENTRY POINT 900. 


EXIT POINT 265 
Have the system unit serviced. 
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Display Failure Problems 


ENTRY POINT 300 

1. Set the system unit On/Off switch to the Off position. 

2. Set the display On/Off switch to the Off position (O). 

3. Verify that the Video cable is properly connected between the 
display station and the display/monitor adapter (see Figure 6-1). 

4. If both the monochrome display adapter and the color display 
adapter are installed and the IBM Monochrome Display and a 
3278 or 3279 are connected, you should know that only one dis- 

. play will be active during POST and 3270ATT initialization. 

5. Verify that the system board display switch setting is correct. 
Refer to the JBM Personal Computer Guide to Operations 
for the correct switch setting. 

6. Set the display On/Off switch to the On position (| ). 
Is the display screen a correct host computer mode display image 
(a data area and an operator information area separated by a line) 
and is the display station operable? See Figure 4-1, in Chapter 4. 

No Yes —Go to ENTRY POINT 330. 

310 

1. Set the display On/Off switch to the Off position (O). 

2. Disconnect the feature bus cable from the distribution box (at 
the system unit). 

3. Set the display On/Off switch to the On position (| ). 


614 Problem Determination 


Procedure 3 


Is the display screen a correct host computer mode display image (a 
data area and an operator information area separated by a line) and 
is the display station operable? See Figure 4-1. 


No Yes 


EXIT POINT 315 
Have the system unit serviced. 


1. Set the display On/Off switch to the Off position (0). 

2. Remove the feature bus cable from the display station end. 

3. Set the display On/Off switch to the On position (| ). 

Is the display problem still the same? 

No Yes — Verify that the host is operational, and that your display 
is properly connected to the device cable. If so, have 


your display serviced. 


EXIT POINT 325 
Have the system unit serviced. 


ENTRY POINT 330 

1. Ready the system disk. 

2. Reconnect the feature bus cable if necessary. (When you power 
on the system unit, the display should immediately switch from 
host computer mode to personal computer mode.) 


3. Set the system unit On/Off switch to On. 


Does the host computer mode image remain on the screen after the 
system unit is powered on? 


No Yes — Go to procedure 7, ENTRY POINT 700 (mode switch 
failures). | 


340 
Wait for the system to complete initialization. 
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Note: If your AUTOEXEC.BAT file switches your system to host 
computer mode, you must switch modes to return to personal com- 
puter mode before answering the next question. 


Is the display in personal computer mode and the screen image OK? 


No Yes 


345 
1. Run the IBM Personal Computer Diagnostics if you have 
not already done so. (See “Diagnostics Aids,” early in 


this chapter, for the IBM Personal Computer Diagnostic 
operating instructions.) 


RETURN HERE WHEN FINISHED. 


Note: Certain color combinations from the color/graphics 
monitor adapter are difficult to read on the 3278 display. 


Did the display tests in the IBM Personal Computer Diagnostics 
run OK? 


No Yes — The display is OK. Return to user operation or to 
the procedure that sent you here. 


350 
1. Set the system unit On/Off switch to Off. 
2. Set the display On/Off switch to the Off position (O). 


3. Disconnect the video and feature bus cables at the display station 
end. (See Figure 6-1.) 


4. Set the display On/Off switch to the On position (| ). 


5. Set the brightness and contrast controls fully clockwise ( CY). 
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Test Mono , \ 


Normal 


| Squeeze tabs 
. and pull out 


Test Color 


Feature Bus 


Cable Video Cable 


Figure 6-1. Video and Feature Bus Cables at 3278 Display 


Is your display connected to a color/graphics monitor adapter in the 
system unit? 


No Yes —Go to ENTRY POINT 370. 


360 
1. At the rear of the display, set the Video Test switch to the Test 


Mono position. (See Figure 6-1.) The video test pattern should 
be like the pattern in Figure 6-2. 
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Alternate Bright and Dim Bars 


Figure 6-2. Test Mono Video Test Pattern 
Is the video test pattern displayed like the pattern in Figure 6-2? 
No Yes 
EXIT POINT 365 
Have the system unit serviced. 
Have the display serviced. 
ENTRY POINT 370 


At the rear of the display, set the Video Test switch to the Test Color 
position. (See Figure 6-1.) Observe the test pattern in Figure 6-3. 
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Bright and 
Dim Bars 


Figure 6-3. Test Color Test Pattern 
Is the video test pattern displayed like the pattern in Figure 6-3? 


No Yes 


EXIT POINT 375 
Have the system unit serviced. 


Have the display serviced. 
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Problems 


ENTRY POINT 400 
1. Set the system unit On/Off switch to Off. 


2. Set the display On/Off switch to the Off position (QO). 


3. Verify that the KEYBOARD ADAPTER CABLE PIGTAIL HAS 
NOT MISTAKENLY BEEN CONNECTED TO THE ADJACENT 
CASSETTE CONNECTOR at the rear of the system unit. (See 
Figure 6-4.) 


Keyboard 
Cable Pigtail 
Connector 


Figure 6-4. Keyboard Adapter Cable Pigtail Connection 


4. Make certain that all cables connecting the system unit, the dis- 
tribution box, and the display are securely connected. 


5. Set the display On/Off switch to the On position (|). You are 
now in host computer mode. 
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6. Do the keyboard tests detailed in the display station Problem 
Determination Guide located in the keyboard. For a 3278, do 
only the keyboard tests. For a 3279, do the control unit tests 
also as far as selecting Test mode using ALT and TEST. Return 
here when finished. | 


7. If you have not already done so, return the display Normal/Test 
switch to Normal. 


8. If your keyboard problem was in host computer mode, test the 
keyboard by performing the keyboard function that failed (for 
_ example, clicker, shift, alt, keystroke). 


Did all the tests run successfully? 


No Yes — Goto ENTRY POINT 430. 


410 
1. Set the display On/Off switch to the Off position (| ). 


CAUTION 

Make sure that you do not connect the personal computer printer 
cable to distribution box connector C or to the keyboard adapter 
cable connector. Such a connection would result in damage to 
your printer and to the system unit. 


2. Disconnect the keyboard cable and the keyboard adapter cable 


from the distribution box, and connect the two cable ends 
together. (See Figure 6-5.) 
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Keyboard Cable 
To Display 

Line up connectors 
properly and push 
together. 

Keyboard 

Adapter 

Cable 


To Keyboard 


Figure 6-5. Keyboard Cable and Keyboard Adapter Cable Connection 


3. 


4 


Set the display On/Off switch to the On position (| ). 


Repeat the keyboard tests from the display station Problem 
Determination Guide located in the keyboard. For a 3278, do 
only the keyboard tests. For a 3279, do the control unit tests 
also as far as selecting Test mode using ALT and TEST. Return 
here when finished. 


If you have not already done so, return the display Test/Normal 
switch to Normal. 


If your keyboard problem was in host computer mode, test the 
keyboard by performing the keyboard function that failed 
(for example, clicker, shift, alt, keystroke). 


Did the tests run successfully this time? 
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No Yes 


EXIT POINT 415 
Have the system unit serviced. 


420 
1. Set the display On/Off switch to the Off position (O). 


2. Disconnect the keyboard cable from the keyboard adapter 
cable. 


3. Disconnect the keyboard adapter cable from the display. (See 
Figure 6-7.) 


4. Connect the keyboard cable to the display station. For a 3278, 
see Figure 6-6. For a 3279, see Figure 6-7. 


5. Set the display On/Off switch to the On position (| ). 


6. Repeat the keyboard tests from the display station Problem 
Determination Guide, located in the keyboard. For a 3278, do 
only the keyboard tests. For a 3279, do the control unit tests 
also as far as selecting Test mode using ALT and TEST. Return 
here when finished. 


7. Ifyou haven’t already done so, return the display Test/Normal 
switch to Normal. 


8. If your keyboard problem was in host computer mode, test the 


keyboard by performing the keyboard function that failed (for 
example, clicker, shift, alt, keystroke). 
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Keyboard Cable 
Connector 


Keyboard Cable 
Socket 


, Keyboard Cable 
Place the keyboard cable clamp over the stud. 


Plug the keyboard cable connector into the right-hand cable socket 
above the letters KEYBD. 


Wing Nut 


@ Replace 
retainer wire 
bottom 

first 


CAUTION 
Make sure that the keyboard cable is fully seated. 


Swing the retainer wire across the cable connector. Insert the bottom 
of the retainer wire in the slot, and latch it into place. The retainer 
wire keeps the connector tightly in place; it therefore takes some 
extra force to latch it into place. (Do not be afraid to apply the 
necessary force.) 


Install and tighten the wing nut. 
Figure 6-6. Connection of Keyboard Cable to 3278 Display 
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Figure 6-7. Connection of Keyboard Cable to 3279 Color Display 
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Did the tests run successfully this time? 


No 


Yes 


EXIT POINT 425 
Have the system unit serviced. 


Have the keyboard serviced. 


ENTRY POINT 430 

1. Ready a system disk. 

2. Set the system unit On/Off switch to On. 

3s | Wait for the system unit to complete the initialization procedure. 

4. Ifnecessary, press the mode switch keys to enter personal com- 
puter mode. 

5. Type q space p (q p) (press three keys) from the keyboard. 
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Do the characters q and p appear on the screen separated by a 
space (q p) ? 


No Yes 


431 
1. Press the mode switch keys to enter host computer mode. 


2. Do the keyboard tests specified in the display station 
Problem Determination Guide, located in the keyboard. 
For a 3278, do only the keyboard tests. For a 3279, do the 
control unit tests as far as selecting Test mode using ALT 
and TEST. RETURN HERE WHEN FINISHED. 


3. Ifyou haven’t already done so, return the display 
Test/Normal switch to Normal. 


Did the keyboard tests run successfully? 


No Yes 


You have completed all the keyboard tests and have 
found no problem. Return to user operation or to the 
procedure that sent you here. 


EXIT POINT 437 
Have the system unit serviced. 


EXIT POINT 439 
Have the system unit serviced. 
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IBM 3270 Personal Computer Attachment Error Codes 
and Messages 


ENTRY POINT 500 


The error codes and messages described in this procedure can appear 
only during 3270ATT initialization; that is, during the power on 
sequence, or during an IBM Personal Computer system reset with a 
system disk in the default drive. 


Table 6-2 gives the error code message you will see on the personal 
computer mode display screen. Do the action recommended for each 
error code message. If you do not get one of these messages during 
the power on sequence or during an IBM Personal Computer system 
reset, exit this procedure and return to user operation or to the pro- 
cedure that sent you here. 


Note: On some 3279 displays, the error code image might appear 
unstable or more than once on the screen. 
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Table 6-2. 19xx Error Codes 


Error Recommended 
Code Message Action 


1901 IBM Personal 1. Check that the IBM 
Computer 3270 Personal Computer 
Adapter Not 3270 Attachment 
Operational Option is properly 


installed. (See Chapter 
2.) 


Go to EXIT POINT 
505. 


If the message still 
appears during 

initialization, have the 
system unit serviced. 
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Table 6-2. 19xx Error Codes (continued) 


Error Recommended 
Code Message Action 


1902 3278/3279 Keyboard Check that all the key- 
Not Supported — board cables and the 
Typewriter Assumed distribution box are 
properly connected. 


If you have just: 


3278/3279 Keyboard 
Not Supported in the 
Specified Language — 
Typewriter Assumed 


a. Installed the IBM 
3270 Personal 
Computer 
Attachment 


Customized or 
recustomized 


Replaced the 
keyboard 


review Chapter 3, 
especially the keyboard 
customization proce- 
dure. Repeat the 
customization proce- 
dure if necessary. 


If none of the condi- 
tions in step 2 (above) 
is true, go to proce- 
dure 4, ENTRY 
POINT 400, and do 
steps 400 to, but not 
including, 430. 
Return here when 
finished. 


Go to EXIT POINT 515. If 
no problems are found and 
1903 still appears, have the 
system unit serviced. 
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Table 6-2. 19xx Error Codes (continued) 


Recommended. — 
Action 


IBM Personal Go to EXIT POINT 525. 

Computer 3270 

Adapter Failure Have the system unit 
serviced. 
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Transfer Problems | 


ENTRY POINT 600 


1. 


Verify that the 3274 Control Unit has been customized for the 
IBM 3270 Personal Computer Attachment. 


. Set the display On/Off switch to the Off position (QO). 
. Set the system unit On/Off switch to Off. 


. Insert a system diskette containing the diagnostic program 


3270DIAG into drive A of the system unit. 


: Set the display On/Off switch to the On position (| ). 


. Set the system unit On/Off switch to On, and wait for the system 


to complete initialization. 


. From the keyboard, type 3270DIAG. Press ENTER and wait 


for the main menu to appear (Figure 6-8). 


The IBM Personal Computer 3270 Attachment Option Diagnostic Program. 
Version 1.10 (C) Copyright IBM Corp. 1982, 1983. 


SELECT AN OPTION 


0 - RUN 3270 Attachment Diagnostics 

1 - RUN Feature Bus Cable Diagnostics 
2 - RUN Data Transfer Wrap Test 

9 - Exit diagnostics 


ENTER THE DESIRED ACTION ->__ 


Figure 6-8. Main Menu 
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8. Press the O key to select the IBM Personal Computer 3270 
Attachment Option Diagnostic. Wait for the second menu to 
appear (Figure 6-9). 


The {BM Personal Computer 3270 Attachment Option Diagnostic Program. 
Version 1.10 (C) Copyright IBM Corp. 1982, 1983. 


SELECT AN OPTION 


O - RUN Test One Time 
1 - RUN Test Multiple Times 
8 - Return to Main Menu 


ENTER THE DESIRED ACTION ->__ 


Figure 6-9. Second Menu 


9. In the menu, select “RUN Test One Time” by pressing the 0 
key. 


10. Wait for operating instructions (Figure 6-10) to appear on the 
screen. Press the spacebar to get to the next screen. 
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The !BM Personal Computer 3270 Attachment Option Diagnostic Program. 
Version 1.10 (C) Copyright IBM Corp. 1982, 1983. 


You Will Be Instructed Shortly to Disconnect The Feature Bus Cable 
From The Distribution box, At Which Time Your Display Will Return 
to Host-Computer Mode. 


To Terminate the 3270 Attachment Diagnostics After They Have Started: 


A. Press (9) Key. 
B. Wait for Short Beep(s). 
C. Reconnect Featura Bus Cable To Distribution Box. 


Press SPACE BAR to Continue 
Or 
Press the (8) Key to Return to Main Menu. 


Figure 6-10. Operating Instructions 


11. Wait for feature bus cable disconnect instructions (Figure 6-11) 
to appear on the screen. 
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The IBM Personal Computer 3270 Attachment Option Diagnostic Program. 
Version 1.10 (C) Copyright |BM Corp. 1982, 1983. 


Disconnect the Feature Bus Cable From the Distribution Box. 


Note Screen Will Revert To HOST-COMPUTER MODE 


Then Press The Space Bar to Continue Test. 


Press the (8) Key to Return to Main Menu. 


Figure 6-11. Feature Bus Cable Disconnect Instructions 


12. Disconnect the feature bus cable from the distribution box 
(at the system unit). (After the cable is disconnected, the 
screen will revert to the host computer mode image.) 

13. Press the spacebar to start the IBM Personal Computer 
3278 Attachment Option Diagnostic. Wait approximately 
3 to 5 seconds for an audio response. 


Did you hear one short beep? 

No Yes — Goto ENTRY POINT 610. 
EXIT POINT 605 

Have the system unit serviced. 


ENTRY POINT 610 
Reconnect the feature bus cable to the distribution box. 


Does your display screen look like Figure 6-12? 


No Yes — Goto ENTRY POINT 620. 


EXIT POINT 615 
Have the system unit serviced. 
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The [BM Personal Computer 3270 Attachment Option Diagnostic Program. 
Version 1.10 (C) Copyright IBM Corp. 1982, 1983. 


Error Log Summary. 
Count. 
Loop Through Diagnostics. 


1950 Error.--------------------- 


1951 Error.--------------------- 


1952 Error --------------------- 


Diagnostics Completed. 


Press The [8] Key To Return to Main Menu. 


Figure 6-12. Error Log Summary 


ENTRY POINT 620 
1. Set the system unit On/Off switch to Off. 
2. Set the display On/Off switch to the Off position (O). 
3. Wait 5 seconds. 
4. Set the display On/Off switch to the On position (| ). 
5. Set the system unit On/Off switch to On. 


6. From the keyboard, type 3270DIAG and then press ENTER. 
Wait for the main menu to appear on the screen (Figure 6-8). 


7. Do the following steps, and record your results on the error- 
recording chart (Table 6-3) or on a separate sheet of paper. 
Use the “1st Pass” column for the first time through the steps 
and the “2nd Pass” column for the second time through. 
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Table 6-3. Error-Recording Chart 


ee 
ENTRY Error Code Error Code 
POINT 620 | Yes | No | Indicator Yes | No | Indicator 


8. Switch the Normal/Test switch from Normal to Test and back. 
9. Press the 1 key to run the Feature Bus Cable Diagnostics. 
Did you get the message 
FEATURE BUS CABLE DIAGNOSTICS COMPLETED 
within 5 seconds? 
10. Record answer Yes or No. 


11. Press the mode switch keys to go into host computer mode. 
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Did the display switch to host computer mode? 
Record your answer. 


No_ Yes 
12. Record any error indicators that appear in the operator 
information area. 


13. Press the mode switch keys to go into personal computer 
mode. 


Did the display switch to personal computer mode? 
Record your answer. 


No Yes 


14. Press the mode switch keys. 
15. Enter any characters from the keyboard. 


Did the characters appear on the screen? 
Record your answer. 


No Yes — Goto ENTRY POINT 630. 

16. Switch the Normal/Test switch from Normal to Test 
and back (once only). 

17. Enter any characters from the keyboard. 


Did the characters appear on the screen? 
Record your answer. 


No Yes 


ENTRY POINT 630 
1. Set the system unit On/Off switch to Off. 


2. Set the display On/Off switch to the Off position (O). 
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3. Disconnect the feature bus cable from the display and from the 
system unit. 


4. Take the end that was connected to the display and connect it 
to the distribution box. Connect the other end to the display. 


5. Set the display On/Off switch to the On position (| ). 


6. Set the system unit On/Off switch to On and wait for the 
system to complete initialization. 


Is the display in host computer mode? 
No Yes 

EXIT POINT 635 

Have the system unit serviced. 
640 


1. From the keyboard, type 3270DIAG and then press ENTER. 
Wait for the main menu to appear on the screen (Figure 6-8). 


2. Do all steps from step 8 ENTRY POINT 620 to, but not 
including, ENTRY POINT 630. Once again, record your answers; 
this time, use the ““2nd PASS” column. 

3. Compare the answers recorded in the two columns. 

Are there any differences? 
No _ Yes 
EXIT POINT 645 
Have the system unit serviced. 
650 
1. Set the system unit On/Off switch to Off. 


2. Wait 5 seconds. 
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3. Set the system unit On/Off switch to On. 


4. From the keyboard, type 3270DIAG and then press ENTER. 
Wait for the main menu to appear on the screen (Figure 6-8). 


5. Press the 2 key to run the Data Transfer Wrap Test. 


Did you receive a WRAPTEST COMPLETE message? 
(Do not wait longer than 5 seconds.) 


No Yes 


Were there any WRAPTEST error messages? 


No Yes — Have the display serviced. 


The file transfer and screen capture hardware is OK. 
Return to the user operation or to the procedure that sent 
you here. 


Have the display serviced. 
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ENTRY POINT 700 


If you were sent here from another procedure in which you removed 
cables, reconnect those cables now. 


1. Set the display On/Off switch to the On position (| ). 
2. Set the system unit On/Off switch to Off. 
Is the display in host computer mode and the screen image OK? 


No Yes 


Go to ENTRY POINT 720. 
710 
1. Set the display On/Off switch to the Off position (O). 
2. Disconnect the feature bus cable from the display. 
3. Set the display On/Off switch to the On position (| ). 
Is the display in host computer mode and the screen image OK? 
No_ Yes 
EXIT POINT 715 
Have the system unit serviced. 
Verify that the host is operational and that eeu display is properly 


connected to the device cable. If no trouble is found, have your 
display serviced. 
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ENTRY POINT 720 


1. Ready a system disk. (When you power on the system unit, 
the display should immediately switch to personal computer 
mode.) 


2. Set the system unit On/Off switch to On. 


Does the display switch to personal computer mode immediately after 
the system is powered on? 


No Yes 


722 
1. Wait for the system to complete initialization. 


2. Press the mode switch keys several times. 
Does the display change modes each time these keys 
are pressed? 


No Yes — The mode switch hardware is functioning properly. 
Return to user operation or to the procedure that 
sent you here. 


Go to procedure 4, ENTRY POINT 400, and do steps 400 to, 
but not including, 430 to test the keyboard. While testing the 
keyboard, make sure that you test the mode switch keys. 
RETURN HERE WHEN FINISHED. 


3. If you haven’t already done so, set the display Test/Normal 
switch to Normal. 


Was a problem found during the keyboard test? 


No Yes — Follow the recommended action for the problem 
found in Problem Determination Procedure 4. 


EXIT POINT 725 
Have the system unit serviced. 


730 
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1. Set the system unit On/Off switch to Off. 


2. Set the display On/Off switch to the Off position (O). 
3. Disconnect the feature bus cable from the display. 

4. Disconnect the video cable from the display. 

5. Set the display On/Off switch to the On position (| ). 


6. Put the Video Test switch to the Test Mono (3278) or Test 
(3279) position. See Figure 6-1 (3278) or 6-13 (3279). 


Did you get the test pattern shown in Figure 6-2 (3278) or 6-15 
(3279)? 


No Yes 
EXIT POINT 735 
Have the system unit serviced. 


Have the display serviced. 
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in the Operator Information Area 


ENTRY POINT 800 


If you see N 69 in the operator information area, you might be 
attached to a 3276 Control Unit Display Station, which does not 
support data transfer. 


A 2% % error code could be caused by the following: 


The 3274 Control Unit does not have Configuration Support 
C, Release 46 or higher, or Configuration Support D, 
Release 60 or higher, installed. 


| The 3274 Control Unit has not been customized for the IBM 


Personal Computer 3270 Attachment Data Transfer control 
function. 


The keyboard customization procedure has not been 
performed correctly. (See Chapter 3.) 


The 3278 Personal Computer Attachment Option Card in the 
system unit has a problem. 


Refer to your display station documentation for other causes of the 
2% % error. 


Machine checks in the range 235 — 238 are posted as a result of 
data transfer problems, that is, a failure during a file transfer or 
screen capture. The likely causes are: 


Any user action that interferes with the execution of the data 
transfer application program in the personal computer; for 
example, doing a keyboard system reset. 


Error in the data transfer application program in the personal 
computer. 


Hardware problems, which Problem Determination Procedure 
6 should detect. 
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810 


Is the indicator a machine check in the range 235 — 238? 


No Yes 


812 


1. Switch the Test/Normal switch from Normal to Test and 
back. 


2. Set the system unit On/Off switch to Off. 
3. Ready a system disk. 
4. Set the system unit On/Off switch to On. 


5. Retry the data transfer operation that was under way when 
the machine check occurred. 


Does a machine check of 235 — 238 recur? 
No Yes 
Go to Problem Determination Procedure 6, 
ENTRY POINT 600, and return here if no problem is 


found. 


Is the data transfer application program running in the 
personal computer operating correctly? 


No Yes — Return to user operation or to the procedure 
that sent you here. 


Correct the application program and retry. 
EXIT POINT 820 


Return to user operation or to the procedure that sent you here. 


Follow the instructions in the display Problem Determination Guide 
(found in the keyboard). 
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Problem Determination Procedure 9: 3279 
Display Failure Problems 


Note: The 3279 Models 2 and 3 have slight differences. For example: 
the Model 2 displays may be slightly brighter than the Model 3 dis- 
plays; and, in personal computer mode, the Model 2 displays have 
horizontal striped characters. 


ENTRY POINT 900 


1. Verify that the video cable is properly connected between the 
display station and the display/monitor adapter (see Figure 6-13). 


2. Set the system unit On/Off switch to Off. 
3. Set the 3279 On/Off switch to the Off position (O). 


4. At the back of the 3279, in the access area, make sure that the 
Normal/Test switch-is set to Normal. See Figure 6-13. 


5. At the system unit, disconnect the feature bus and video cables. 
See Figure 6-14. 


6. Set the 3279 On/Off switch to the On position (| ). 
| Normal/Test 
Switch 


s 
Video Cable Feature Bus Cable 
(IBM Part 4752128) (IBM Part 4752127) 


Figure 6-13. Feature Bus and Video Cables on the 3279 
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Video Cable : Feature Bus Cable 
(IBM Part 4752128) (IBM Part 4752127) 
to Color/ Graphics to Socket B on the 
Monitor Adapter Distribution Box 


Figure 6-14. Distribution Box on the System Unit 


Does the 3279 show a correct host computer mode image, and is the 
display station operable? (You should have a data area above the line 
and an operator information area below the line.) 


Yes No 


Disconnect the feature bus and video cables from the 3279. 
See Figure 6-13. 


Is the problem still the same? 


No Yes— Verify that the host is operational and that your 
display is properly connected to the device cable. 
If no trouble is found, refer to the symptom index 
in the Problem Determination Guide for your 
3279 Color Display Station. 


EXIT POINT 915 
Service your system unit. 


ENTRY POINT 920 
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1. Set the 3279 On/Off switch to the Off position (O). 

2. Reconnect the feature bus and video cables to the system unit. 
3. Set the 3279 On/Off switch to the On position (| ). 

Does the 3279 show a correct host computer mode image? 


Yes No — Goto EXIT POINT 925. (Have your system unit 
serviced.) 


ENTRY POINT 930 

At the system unit: 

1. Ready a system disk. 

2. Set the On/Off switch to On. 
Note: On some models of the 3279 color display, the screen may 
have an unstable image and multiple images. This condition is 
normal for this step. 


Does the 3279 show a correct host computer mode image? 


No Yes— Go to Procedure 7, ENTRY POINT 700. 
ENTRY POINT 940 


Wait for the system unit to complete initialization (this may take up 
to 90 seconds). 
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Does the 3279 show a correct personal computer mode image? (If the 
displayed characters are the wrong color, answer No.) 


No Yes 


ENTRY POINT 945. 

Run the IBM Personal Computer Diagnostics if you have not 
already done so. (See ‘“‘Diagnostic Aids,”’ early in this chapter, 
for instructions.) 


Did the display tests in the diagnostics run OK? 


No Yes— The 3279 is OK. Return to the procedure that 
sent you to this procedure. 


ENTRY POINT 950 
1. Set the system unit On/Off switch to Off. 


2. Set the 3279 On/Off switch to the Off position (O). 


3. Disconnect the feature bus and video cables from the 3279. See 
Figure 6-14. 


4. Set the 3279 On/Off switch to the On position (| ). 
5. Set the brightness control fully clockwise. 


6. Set the Video Test switch to Test at the back of the 3279. See 
Figure 6-13. 


Check the displayed video test pattern against the pattern shown in 
Figure 6-14. Is the displayed pattern the same as shown in the figure? 


No Yes 
EXIT POINT 975 
Service your system unit. 


Service your 3279. 
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The number of color bays at 
the left (and right) sides of 
the pattern may vary. 


—— 


130—140 mm 
(Model 2) 
170—180 mm 
(Model 3) 


_ 


E 

wll} {3 
E/5/Zi2|2 
Tlal<|3)a 
S(Slolal > 


Notes: 
1. The color bars should have straight edges. 


2. Adjacent bars should have no overlap or blank spaces between 
them (except the black bars). 


3. Black bars should not show any trace of color. 

4. The height of the displayed bars should be: 
@ IBM 3279 Model 2: between 130 and 140 mm 
e IBM 3279 Model 3: between 170 and 180 mm 

5. If the edges of the bars are not sharp, do the color convergence 
procedure and then recheck the color test pattern. (The con- 


vergence procedure is described in the Problem Determination 
Guide stored in your keyboard.) 


Figure 6-15. Color Test Pattern for the 3279 Color Display Station 
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Appendix A. Assembler Application 
Program Interface 


Introduction 


This appendix describes the interface between a personal com- 
puter application program and the IBM 3270 Personal Com- 
puter Attachment BIOS extension. (See Figure A-1.) 


Personal a 3270 
Computer Lat Attachment 
Application BIOS 


Extension 


Interrupt 
Handler 
Extensions 


IRET 
CALL (Far) 


3270 
Attachment 
Interrupt 

Handler 


Data Transfer IR ET 
Screen Capture 


Wrap Test 
Figure A-1. Diagram of Assembler Application Program Interface 


The customization process creates the BIOS extension 
(3270ATT.EXE) on your IBM 3270 Personal Computer Attach- 
ment DOS diskette. The AUTOEXEC.BAT file starts up 
3270ATT.EXE. Then 3270ATT.EXE handles both: 


e Hardware interrupts from the Personal Computer 3270 
Attachment Adapter 


e Software interrupts from a personal computer application 
program. 


3270ATT.EXE occupies approximately 5K of memory above 
the old end of DOS. 
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The BIOS extension provides a sofware interrupt interface for 
personal computer application programs to control the opera- 
tion of the IBM 3270 Personal Computer Attachment. This 
interface is similar to the function calls used to communicate 
with DOS. 


In order to request a function, an application program puts the 
desired function code into the AH register, puts any other 
required parameters into the appropriate registers, and executes 
an INT 50H instruction. 


All registers are preserved by the BIOS extension, except for: 


e@ The carry flag (CF), which indicates whether the function 
was accepted 


e@. The AX register, which contains a return code (in the AL 
portion of the register) 


e The BX register, which contains returned information for 
certain function calls. 


The BIOS extension uses the application program’s stack to save 
registers and other information. The application program’s stack 

area should be at least 128 bytes larger than the requirements of 
the application program. 


The terms used to define the function codes for interrupt 50H 
in this appendix are listed here: 


@ Reg = Contents of a register or a pointer 

e ValueH = Hexadecimal value 

e Seg:reg = Contents of a register based on a segment 
register 

e <AH,AL, etc = Register name 

e CF = Carry flag 

e.. Bits = Bit 7 is most significant, 0 least significant 

e Control unit = IBM3274 Control Unit, IBM 3276 Control 


Unit Display Station, or IBM Integrated 
Display Adapter (IDA) 
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Function Code 0: Set Mode 


The set mode function associates the 3278/3279 keyboard and 
display either with the program running in the personal com- 
puter or with the program running in the host. 


You can use this function with a display connected to any con- 
trol unit. 


The 3278/3279 keyboard and display can associate indepen- 
dently with the personal computer or with the host. When the 
3278/3279 keyboard and display both associate with the per- 
sonal computer (for example, the program running on the per- 
sonal computer receives all keystrokes and the display is show- 
ing the image from the personal computer display adapter), the 
terminal is in personal computer mode. If you enter the mode 
switch key sequence at the 3278/3279 keyboard (ALT and 
INSERT on most keyboards), the terminal is switched to host 
computer mode. 


When the 3278/3279 keyboard and display associate with the 
host (for example, the control unit receives all keystrokes and 
the display is showing the image from the control unit), the 
terminal is in host computer mode. If you enter the mode 
switch key sequence at the 3278/3279 keyboard, the terminal 
is switched to personal computer mode. 


The 3278/3279 keyboard can associate with the personal com- 
puter, and the display can associate with the host. In this mode 
of operation, a program running on the personal computer can 
monitor all keystrokes from the 3278/3279 keyboard and selec- 
tively pass them on to the control unit for processing. 


For example, a personal computer application program could 
be written that monitors for special key sequences (such as F11 
through F40) and substitutes character strings for the special 
key sequences (such as a programmed “‘soft key”’ facility for 
TSO or VM/370). If you enter the mode switch key sequence 
in this mode, the terminal is switched to host computer mode. 
Since the image shown will not change, you will not be able to 
see any difference in the display. However, the personal com- 
puter application program will lose control of the keyboard. 
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The 3278/3279 keyboard can associate with the host, and the 
display can associate with the personal computer. If you enter 
the mode switch key sequence in this mode, the terminal is 
switched to personal computer mode. Since the image shown 
will not change, you will not see any difference in the display. 
However, the control unit will no longer be receiving the 


keystrokes. 
Invocation 
AH 0 
AL 0O—Change to host computer mode 
AL 1—Change to personal computer mode 
AL 2—Display host computer image; do not change 
| keyboard association 
AL 3—Display personal computer image; do not change 
keyboard association 
Accepted 
CF 0 
AL 0 
Rejected 
CF 1 
AL 2—Invalid mode set code 


Return code 2 indicated that the AL register did not contain a 
valid value (0, 1, 2, or 3). 


Example 

SS > CHANGE TO HOST COMPUTER MODE 
MOV AH,O ;FUNCTION = SET MODE 
MOV AL,O ;SELECT HOST COMPUTER MODE 
INT 50H 
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Function Code 1: Send Keystrokes to the 
3278/3279 Keyboard Interface 


The send keystroke function sends keystrokes to the con- 
trol unit as if you were pressing the keys on the actual 
3278/3279 keyboard. The keystrokes are sent at a maximum 
rate of 10 keystrokes per second. 


You can use the send keystroke function in two different ways. 
First Method 


The first way of using the send keystroke function can be used 
with a display connected to any control unit. 


Invocation (without an Active Interrupt Handler Extension) 


AH 1 
CX Length of buffer 
DS:DX Address of buffer containing keystroke encodings 
(see Table A-1) 
Accepted 
CF 0 
AL 0 
Rejected 
CF 1 
AL 4—Invalid keystroke encoding in the message 


Return code 4, invalid keystroke encoding, indicates that CX=0 
or a keystroke encoding found in the message is not valid for 
the type of 3278/3279 keyboard that is attached to the per- 
sonal computer. Table A-1 lists all the possible keystroke 
encodings. However, you can only use the encodings that cor- 
respond to the actual keys on the 3278/3279 keyboard you are 
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using. For example, the typewriter/APL keyboards do not have 
PF13—PF24 keys. Therefore, you cannot use keystroke encod- 
ings corresponding to PF13—PF24 on a typewriter/APL 
keyboard. 


With this method of sending keystrokes, part of the message 
might not reach the control unit if the 3278/3279 keyboard 
became locked during the keystroke transfer. For example, 
when a message is received from the host during keystroking, 
and the keyboard is locked because of a previous ENTER key- 
stroke, the keystrokes run into an attribute byte. Use this 
method only when you are not sure the display is connected to 
a 3274 Control Unit customized for the 3270 Personal Com- 
puter Attachment. 


Example 


jeer ess = DEFINE OUTPUT BUFFER 
BUFFER_LENGTH DW BUFFER_END-BUFFER 


BUFFER DB ‘THIS IS AN EXAMPLE FOR SEND KEYSTROKES' ,8AH 
BUFFER_END EQU $ 


{<S=S=s= SEND KEYSTROKES TO THE 3278/3279 KEYBOARD INTERFACE 


SEND_KEYSTROKES: 


MOV AH,1 ;FUNCTION = SEND KEYSTROKES 
LEA DX, BUFFER ; ADDRESS OF KEYSTROKE BUFFER 
MOV CX,BUFFER_LENGTH ; LENGTH OF BUFFER 

INT 50H 

JNC DONE ;FUNCTION SUCCESSFUL - CONTINUE 


pooo----- OPERATION REJECTED - TAKE CORRECTIVE ACTION 


Second Method 


The second way of using the send keystroke function requires 
a display that is connected to a 3274 Control Unit customized 
for the IBM 3270 Personal Computer Attachment. To use this 
form of the send keystroke function, your application program 
must issue the set 3270 attachment interrupt vector function 
(for any of the allowable types of data transfer) before issuing 
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the send keystroke function. If there is an active 3270 Attach- 
ment Interrupt Vector when the send keystroke function is 
issued, the BIOS extension determines whether the keystrokes 
actually reached the 3274 Control Unit. 


Invocation (with an Active Interrupt Handler Extension) 


AH 1 

CX Length of buffer 

DS:DX Address of buffer containing keystroke encodings 
(see Table A-1) 


Accepted 
CF 0 
AL 0 
Rejected 
CF 1 
AL 4—Invalid keystroke encoding the message 
AL 6—Power on reset received from the 3274 Control 
Unit 
AL 10—Keyboard is inhibited because of a previous 
keyboard attention being processed 
AL 11—Keyboard is inhibited 
AL 12—Keyboard became inhibited because of an atten- 
tion-generating keystroke in the message. The 
entire message was received by the 3274 Con- 
trol Unit. 
AL 13—Keyboard became inhibited while sending key- 


strokes. The message may have been partially 
received by the 3274 Control Unit. 


Return code 4, invalid keystroke encoding, indicates that CX=0 
or a keystroke encoding found in the message is not valid for 
the type of 3278/3279 keyboard that is attached to the personal 
computer. Table A-1 lists all the possible keystroke encodings. 
However, you can only use the encodings that correspond to the 
actual keys on the 3278/3279 keyboard you are using. For 
example, the typewriter/APL keyboards do not have PF13—PF24 
keys. Therefore, you cannot use keystroke encoding corre- 
sponding to PF13—PF24 on a typewriter/ APL keyboard. 
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Return code 6, power on reset, can result for the first message 
sent after the set 3270 attachment interrupt vector function is 
issued. This code indicates the 3274 Control Unit acknowledges 
the IBM 3270 Personal Computer Attachment is active. In this 
case, your application program should resend the keystroke 
sequence. If return code 6 results after the first message is 
successfully sent, it means that (1) the display was turned off 
and on, (2) the Test/Normal switch was switched to Test and 
back to Normal, or (3) the 3274 Control Unit went through the 
initial machine load (IML) procedure. In this case, the connec- 
tion to the host was probably lost. Your application program 
should switch to host computer mode to allow the user to re- 
establish the host session. 


Return code 10, previous attention pending, results if the pre- 
vious message has not been processed by the host. Your appli- 
cation program should reissue the send keystroke function until 
the return code changes. 


Return code 11, keyboard inhibited, results if the keyboard is 


locked before sending your message. This code indicates 
that: 


@ The host computer program did not unlock the keyboard. 


e You tried to send a keystroke when the cursor was pointing 
to an attribute byte or a protected field. 


e You tried to send a keystroke when the host was sending a 
message to the terminal. 


Your application program can retry sending the message by send- 
ing a RESET keystroke first (either separately or at the begin- 
ning of the original message). If the problem is that the cursor 
is positioned incorrectly, your application program may have to 
send a TAB, BACK TAB, HOME, or CLEAR keystoke after the 
RESET, before sending the message again. 


Return code 12, keyboard now inhibited, results if your mes- 
sage was completely accepted by the 3274 Control Unit and 
your message ended with a keystroke that caused an attention 
interrupt (for example, ENTER, PA1, PA2, CLEAR). Since this 
is a normal condition, no error recovery is required. 
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Return code 13, keyboard became inhibited, results if the key- 
board was unlocked before you sent your message and became 
locked during transmission of the keystrokes. The exception is 
an attention-generating keystroke at the end of the message. 
Your application program can resend the message by sending a 
RESET keystroke and a BACK TAB or CLEAR keystroke, and 
resending the original message. However, this can return the 
same error if the keyboard became locked because of an error in 
formatting the message. Examples are two attention-generating 
keystrokes in the same message and a message that extends past 
the end of the current input field. 


Example 


pers S= DEFINE OUTPUT BUFFER 


BUFFER_LENGTH DW BUFFER_END-BUFFER 


BUFFER DB 'THIS IS AN EXAMPLE FOR SEND KEYSTROKES' ,8AH 
BUFFER_END EQU $ 


jenee-cee 3270 ATTACHMENT INTERRUPT HANDLER EXTENSION 


INT HANDLER PROC FAR 


INT HANDLER  ENDP 


pewerrcm- DEFINE A 3270 ATTACHMENT INTERRUPT HANDLER EXTENSION 


MOV AH,2 ;FUNCTION = SET INTERRUP VECTOR 
MOV AL,l ; FOR SCREEN CAPTURE MESSAGES 
MOV DX,OFFSET INT HANDLER ;ADDRESS OF INTERRUPT HANDLER 
INT 50H 


== S==—> SEND KEYSTROKES TO THE 3278/3279 KEYBOARD INTERFACE 


SEND_KEYSTROKES : 


MOV AH,1 ;FUNCTION = SEND KEYSTROKES 

LEA DX,BUFFER ; ADDRESS OF KEYSTROKE BUFFER 
MOV CX,BUFFER_LENGTH ; LENGTH OF BUFFER 

INT 50H 

JNC DONE ;FUNCTION SUCCESSFUL - CONTINUE 


pooccccc OPERATION REJECTED - TAKE CORRECTIVE ACTION 
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ASCII-to-Keystroke Translation 


Table A-1. 


ESCAPE 
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Table A-1. ASCII-to-Keystroke Translation 
(continued) 


ENTER 


Start 
ALT 


Cl End ALT _| 


APL 
ON/OFF 

TEXT 
ON/OFF 


ix 
1O 
Ea 
/3 
4 
5 
16 
9 
/C 
(D 


Notes: 


1. If a particular keyboard does not have a specified key (for example, 
SKIP does not exist on the typewriter keyboard), the equivalent 
keystroke encoding is invalid. 


2. Tosend a series of one or more keystrokes for which you normally 
must hold the ALT key (for example, the special APL or TEXT key), 
send the START ALT encoding, the normal encoding for the keys, 
then the END ALT encoding. 
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Function Code 2: Set 3270 Attachment 
Interrupt Vector 


The set 3270 attachment interrupt vector function associates an 
interrupt handler extension with a particular type of data flow 
between the IBM Personal Computer and the 3274 Control Unit. 


This function can be used only with a display attached to a 
3274 Control Unit customized for the IBM 3270 Personal Com- 
puter Attachment. 


The interrupt handler extension is called by the BIOS extension 
when data is received from the 3274 Control Unit about the 
type of data flow. See “3270 Attachment Interrupt Handler 
Extension Interface,” later in this appendix, for details about 
coding the interrupt handler extension. 


Invocation 
AH 2 
AL O—Set data transfer interrupt vector 
AL |. 1—Set screen capture interrupt vector 
AL 2—Set wrap test interrupt vector 


DS:DX Address of interrupt handler extension entry point 


Accepted 
CF 0 
AL 0 
Rejected 
CF 1 
AL 3—IBM Personal Computer 3270 Adapter not 
operational 
AL 5—Invalid interrupt vector code 
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Return code 3, IBM Personal Computer 3270 Adapter not 
operational, indicates that the IBM Personal Computer 3270 
Adapter is not installed or is not operational, or that the POST 
for the feature bus interface portion of the adapter failed. 


Return code 5, invalid vector code, indicates that the AL regis- 
ter did not contain a valid value (0, 1, or 2). 


Example 


a lr aac 3270 ATTACHMENT INTERRUPT HANDLER EXTENSION 


INT HANDLER PROC FAR 


RET 


INT HANDLER ENDP 


poccc---- DEFINE A 3270 ATTACHMENT INTERRUPT HANDLER EXTENSION 


MOV AH, 2 ;FUNCTION = SET INTERRUPT VECTOR 
MOV AL,1l ; FOR SCREEN CAPTURE MESSAGES 
MOV DX,OFFSET INT HANDLER ; ADDRESS OF INTERRUPT HANDLER 
INT 50H 
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Function Code 3: Reset 3270 Attachment 
Interrupt Vector 


The reset 3270 attachment interrupt vector function disassoci- 
ates an interrupt handler extension from a particular type of 
data flow between the IBM Personal Computer and the 3274 
Control Unit. 


This function can be used only with a display attached to a 
3274 Control Unit customized for the IBM 3270 Personal Com- 
puter Attachment. 


The interrupt handler extension is not called by the BIOS exten- 
sion when data is received from the 3274 Control Unit. If data 
is received from the 3274 Control Unit and no interrupt handler 
extension is present for that data type, the data is discarded. 
When all three 3270 attachment interrupt vectors are reset, the 
BIOS extension disables the feature bus interface between the 
personal computer and the display. 


Invocation 
AH 3 
AL O—Reset data transfer interrupt vector 
AL 1—Reset screen capture interrupt vector 
AL 2—Reset wrap test interrupt vector 
Accepted 
CF 0 
AL 0 
Rejected 
CF 1 
AL 3—IBM Personal Computer 3270 Adapter not 
operational 
AL 5—Invalid interrupt vector code 
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Return code 3, IBM Personal Computer 3270 Adapter not oper- 


ational, indicates that the IBM Personal Computer 3270 Adapter 
is not installed or is not operational, or that the POST for the 
Feature Bus Interface portion of the adapter failed. 


Return code 5, invalid vector code, indicates that the AL regis- 
ter did not contain a valid value (0, 1, or 2). 


Example 


paese sees CANCEL A 3270 ATTACHMENT INTERRUPT HANDLER EXTENSION 


MOV AH, 3 ;FUNCTION = RESET INTERRUPT VECTOR 
MOV AL,1 ; FOR SCREEN CAPTURE MESSAGES 
INT 50H 


Function Code 4: Set 3270 Attachment Input 


Buffer Address 


The set 3270 attachment input buffer address function specifies 
an input buffer to be used for any data received from the 3274 
Control Unit for a particular type of data flow. 


This function can be used only witha display attached to a 3274 
Control Unit customized for the IBM 3270 Personal Computer 
Attachment. 


An input buffer can be specified for a data flow only if an inter- 
rupt handler extension is active for that type of data. Whenever 
a message is received from the 3274 Control Unit for that data 
type, the BIOS extension saves the data in the specified input 
buffer and calls the interrupt handler extension when the mes- 
sage is complete. Then, the input buffer is not available for 
receiving data until the interrupt handler extension returns to 
the BIOS extension or until the interrupt handler extension 
specifies a new input buffer address. 
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Invocation 


AH 4 

AL O—Set data transfer input buffer. The minimum 
length of the buffer is 2K bytes. 

AL 1—Set screen capture input buffer. The minimum 


length of each buffer is 4 plus the number of 
characters on the display screen that you want to 
capture. (See Function Code 5 for further expla- 
nation.) Note that the screen capture will always 
Start at the upper left corner of the screen. For 
example, if you want to capture the first two lines 
from the screen of Model 2, then the number of 
characters is 160. 


AL 2—Set wrap test input buffer. The minimum length 
: of the buffer is 256 bytes. 

CX Length of input buffer. If CX equals 0, then 
DS:DX is ignored and assumed to be 0 (no input 
buffer available). 

DS:DX Address of input buffer 

Accepted 
CF 0 
AL 0) 
Rejected 

CF l 

AL 3—IBM Personal Computer 3270 Adapter not 

operational 

AL 5—Invalid interrupt vector code 


Return code 3, IBM Personal Computer 3270 Adapter not oper- 
ational, indicates that the IBM Personal Computer 3270 Adapter 
is not installed or is not operational, or that the POST for the 
feature bus interface portion of the adapter failed. 


Return code 5, invalid vector code, indicates that the AL register 
did not contain a valid value (0, 1, or 2), or that the application 
program did not previously issue the set 3270 attachment inter- 
rupt vector function for that data type. 
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Example 


Loree DEFINE INPUT BUFFER 


_ BUFFER_LENGTH DW BUFFER_END-BUFFER 
BUFFER DB 1924DUP (?) 


BUFFER. END EQU $ 


pr ne SET SCREEN CAPTURE INPUT BUFFER ADDRESS 


MOV AH,4 ;FUNCTION = SET INPUT BUFFER ADDRESS 
MOV AL,1l ; FOR SCREEN CAPTURE MESSAGES 

MOV DX,OFFSET BUFFER ; ADDRESS OF INPUT BUFFER 

MOV CX, BUFFER LENGTH ; LENGTH OF INPUT BUFFER 

INT 50H 


Function Code 5: Send Message to 3274 via 
Feature Bus Interface 


The send message function sends a message to the 3274 Control 
Unit using the feature bus interface. 


This function can be used only with a display attached to a 
3274 Control Unit customized for the IBM 3270 Personal Com- 
puter Attachment. 


A message can be sent to the 3274 for a data flow only if an 
interrupt handler extension is active for that type of data. 


Invocation 
AH 5 
AL O—Send data transfer message 
AL 1—Send screen capture options message 
AL 2—Send wrap test message 
CX Length of message 


DS:DX Address of message 
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Accepted 


CF 0 
AL 0 
Rejected 
CF 1 
AL 3—IBM Personal Computer 3270 Adapter not 
operational 
AL 5—Invalid vector code or interrupt vector not set 
AL 6—Message canceled by a power-on reset 
AL 7—Message canceled because of a protocol violation 
AL 8—Message canceled by a user request 


Return code 3, IBM Personal Computer 3270 Adapter not oper- 
ational, indicates that the IBM Personal Computer 3270 Adapter 
is not installed or is not operational, or that the POST for the 
feature bus interface portion of the adapter failed. 


Return code 5, invalid vector code, indicates that the AL register 
did not contain a valid value (0, 1, or 2), or that the application 
program did not previously issue the set 3270 attachment inter- 
rupt vector function for that data type. 


Return code 6, power on reset, can result for the first message 
sent after issuing the set 3270 attachment interrupt vector func- 
tion. This code indicates that the 3274 Control Unit acknowl- 
edges that the personal computer attachment is active. In this 
case, your application program should resend the message. If 
return code 6 results after the first message is successfully sent, 
the display was turned off and on, the Test/Normal switch was 
switched to Test and back to Normal, or the 3274 Control Unit 
went through the IML procedure. In this case, the connection 
to the host was probably lost. Your application program should 
switch to host computer mode to allow the user to reestablish 
the host session. 
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Return code 7, protocol violation, indicates that the 3274 Con- 

trol Unit has rejected the message. This can occur when a Wrap 

Test message longer than 252 bytes or a Screen Capture Options 
message longer than 1 byte is sent. 


Return code 8, canceled by user request, indicates that the appli- 
cation program issued a cancel message function for that data 
flow before the message was sent to the 3274 Control Unit. 

The buffer for a data transfer message must contain no more 
than 2048 bytes of data. This data normally consists of one or 
more structured fields. (See Appendix G for the format of the 


structured fields used by the sample file transfer application 
program.) 


The buffer for a set screen capture options message must con- 
tain 1 byte of data. This byte tells the 3274 Control Unit what 
type of data will be sent to the personal computer when the 
user presses the PRINT key on the 3278/3279 keyboard. The 
data must be one of the following: 

e 80H Send only character buffer 

e 40H _ Send only extended attribute buffer 

@e COH Send character buffer and extended attribute buffer 


e OOH Do not send any data to the personal computer 


If your application program uses the screen capture facility, it 
must invoke the following functions: 


e Set 3270 Attachment Interrupt Vector — Screen Capture 


e Set 3270 Attachment Input Buffer Address — Screen 
Capture 


@ Send Message — Screen Capture Options (80H, 40H, 
or COH) 


. (process data) 
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e Send message — Screen Capture Options (OOH) 


e Reset 3270 Attachment Interrupt Vector — Screen Capture 


The application program can either process local copy requests 
from the user or read the screen buffers at any time by sending 
PRINT keystrokes to the 3274 Control Unit (using the send 

keystroke function). 


Example 


feeeeeecs DEFINE SCREEN CAPTURE OPTIONS MESSAGE 


BUFFER LENGTH DW 
BUFFER DB 
BUFFER_END EQU 


BUFFER_END-BUFFER 
80H 


$ 


;SEND ONLY CHARACTER BUFFER 


fHSSeeeco SEND SCREEN CAPTURE OPTIONS MESSAGE TO 3274 CONTROL UNIT 


MOV 
MOV 
MOV 
MOV 
INT 


AH, 5 

AL, 1 

DX ,OFFSET_BUFFER 
CX,BUFFER_LENGTH 
50H 


;FUNCTION = SEND MESSAGE 
;SCREEN CAPTURE OPTIONS MESSAGE 
; ADDRESS OF OUTPUT BUFFER 

; LENGTH OF OUTPUT BUFFER 
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Function Code 6: Cancel Message Sent to 3274 


The cancel message function cancels a message previously sched- 
uled using the send message function. The message is canceled 
only if the BIOS extension has not already started sending the 
message to the 3274 Control Unit. Since programs running 
under IBM Personal Computer DOS cannot have multiple tasks 
running at the same time, the only use for this function is within 
an interrupt handler. For example, a BREAK interrupt handler 
is called directly from the keyboard BIOS. 


This function can be used only with a display attached to a 
3274 Control Unit customized for the IBM 3270 Personal Com- 
puter Attachment. 


Invocation 
AH 6 
AL O—Cancel data transfer message 
AL 1—Cancel screen capture options message 
AL 2—Cancel wrap test message 
Accepted 
CF 0 
AL 0 
Rejected 
CF l | | 
AL 3—IBM Personal Computer 3270 Adapter not 
operational 
AL 5—Invalid interrupt vector code 


Return code 3, IBM Personal Computer 3270 Adapter not 
operational, indicates that the IBM Personal Computer 3270 
Adapter is not installed or not operational, or that the POST for 
the feature bus interface portion of the adapter failed. 


Return code 5, invalid vector code, indicates that the AL register 
did not c»ntain a valid value (0, 1, or 2). 
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Example 


Tata taeteas CANCEL SCREEN CAPTURE OPTIONS MESSAGE 


MOV AH,6 ;FUNCTION = CANCEL MESSAGE 


MOV AL,1l ; SCREEN CAPTURE OPTIONS MESSAGE 
INT 50H 


Function Code 7: Modify Keyboard Input 
Translation Table 


The modify keyboard input translation table function changes 
the translation table used by the BIOS extension. The table con- 
verts keystrokes from the 3278/3279 keyboard for use by an 
application program running on the personal computer. 


This function can be used with a display attached to any control 
unit. 


When you press a key on the 3278/3279 keyboard, the BIOS 
extension does the following: 


e Reads the 3278/3279 keyboard scan code 


e Translates the scan code to a relative key number (see Fig- 
ure A-2) 


@ Uses the relative key number and current keyboard state as 
an index into the Keyboard Input Translation Table to find 
the required personal computer keyboard state and scan 
code 


e Sends the appropriate series of keystrokes to the personal 
computer 


By modifying the Keyboard Input Translation Table, your 
application program can change the assignment of personal 
computer functions on the 3278/3279 keyboard. For example, 
you can change the SYS REQ key to be the personal computer 
ESC function by setting the table entry for relative key 58 when 
in ALT case to return scan code 1. 
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Invocation 


AH 7 

CH 3278/3279 relative key number 1 to 89 (see Fig- 
ure A-2) 

CL 1—Lowercase (alphacase on data entry keyboards) 

CL 2—Uppercase (numeric case on data entry 

keyboards) 

CL 3—Personal computer Ctrl case 

CL 4—Personal computer Alt case 

CL 5—Alt case 

DH Personal computer scan code (1 to 83), special func- 
tion value (-1 to -14), or ignore keystroke (0) 

DL Required Personal Computer Keyboard State 


Oxxxxxxx Lowercase 

1xxxxxxx Uppercase 

x1xxxxxx Ctrl case 

Xx1xxxxx Alt case 

xxxxxx10 Send break/Alt after keystroke 


Special Function Values 


Some of the keys on the 3278/3279 keyboard identify functions 
that do not exist on the personal computer keyboard. Because 
of the 3270ATT interrupt handler, these functions are available 
in personal computer mode. Examples are the clicker key and 
3278/3279 ALT key. Also, some of the functions available as a 
key on the personal computer keyboard are not defined as keys 
on the 3278/3279 keyboard. To specify these special functions, 
you use the following values as personal computer scancode: 


Shift Lock key 

Left Hand Shift key 

Right Hand Shift key 

Numeric Lock key 

Numeric Shift key 

Alphanumeric Shift key 

ALT key 

Reset key 

Clicker On/Off key 

Start Decimal Input key 

Toggle Mode key 

Enter personal computer CTRL case 
Enter personal computer ALT case 
—14 Pause until another key is hit 


| 
CON DAHA ARWNE 


ie ed 
WN — © OO 
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Look at Table 4-1 for further information. Note that the 
3278/3279 Shift, Shift Lock, and ALT keys generate a make, 
and not a break, key bit. Reassigning these keys to other keys 
will lock your keyboard when you use these keys. 


Accepted 
CF 0 
AL 0 
BX Previous contents of the input translation table 
entry 
Rejected 
CF 1 
AL 9—Invalid parameters 


Return code 9 indicates that register CH did not contain a valid 

value (1—89), register CL did not contain a valid value (1—5), or 

register DH did not contain a valid value (-14 through 83). 
Example 


prcccm-on MODIFY KEYBOARD INPUT TRANSLATE TABLE 


MOV AH,7 ;FUNCTION = MODIFY KBD INPUT TABLE 
MOV CH,58 ; 3278/3279 ATTN KEY 

MOV CL,4 ; WHILE IN ALT CASE 

MOV DH,1 ; BECOME ESC KEY 

MOV DL,OOH ; (LOWER CASE) 

INT 50H 

MOV OLD , BX ;SAVE THE OLD TABLE ENTRY 


{HSS le Ses THE SYS REQ KEY (ALT AND ATTN ON THE 3278/3279 KEYBOARD) IS 
(Sess 7 = NOW SEEN BY A PERSONAL COMPUTER PROGRAM AS THE ESC KEY 


{Hesse == RESTORE KEYBOARD INPUT TRANSLATE TABLE 


MOV AH,7 ;FUNCTION = MODIFY KBD INPUT TABLE 
MOV CH, 58 ; 3278/3279 ATTN KEY 

MOV CL,4 ; WHILE IN ALT CASE 

MOV DX ,OLD ; BECOME ORIGINAL VALUE 

INT 50H 


poocc---- THE SYS REQ KEY (ALT AND ATTN ON THE 3278/3279 KEYBOARD) IS 
pocc-co-- NOW RESTORED TO ITS ORIGINAL ENCODING (WHICH IS IGNORE 
prccen--- KEYSTROKE) 
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Function Code 8: Modify Keystroke Output 
Translation Table 


The modify keystroke output translation table function changes 
the translation table used by the BIOS extension when key- 
strokes are sent from an application program to the control unit. 


This function can be used with a display connected to any con-. 
trol unit. 


When an application program invokes the send keystroke func- 
tion, the BIOS extension does the following: 


e Uses the keystroke encoding as an index to the Keystroke 
Output Translation Table and finds the required 3278/3279 
Keyboard state and relative key number 


e Translates the relative key number to a 3278/3279 key- 
board scan code 


e Sends the appropriate series of keystrokes to the control 
unit. 


By modifying the Keyboard Output Translation Table, your 
application program can change the assignment of keystroke 


encodings. 
Invocation 
AH 8 
CH Keystroke encoding (0 to 255) 
DH 3278/3279 Relative key number 1 to 89 (see Fig- 
ure A-2) or ignore keystroke (0) | 
DL Required 3278/3279 keyboard state 


Oxxxxxxx Lowercase 

1xxxxxxx Uppercase 

xx1xxxxx Alt case or start of sequence of Alt 
keystroke 

XXxxxxX1x End of sequence of Alt keystrokes 
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lit into two keys (75, 89) on a keyboard. 


| Figure A-2. 3278/3279 Relative Key Numbering 


Accepted 


CF 0 
AL 0 
BX Previous contents of the input translation table 
entry 
Rejected 
CF 1 
AL 9—Invalid parameters 
Return code 9 indicates that register DH did not contain a valid 
value (0O—89). 
Example 


[eee e ee MODIFY KEYSTROKE OUTPUT TRANSLATION TABLE 


MOV AH, 8 ;FUNCTION = MODIFY KEYSTROKE OUTPUT TABLE 
MOV CH,'3' ; THE PERCENT SIGN ENCODING 

MOV DH, 67 ; BECOMES FIELD MARK 

MOV DL,O ; (LOWER CASE) 

INT 50H 

MOV OLDPCT , BX ;SAVE OLD TABLE ENTRY 


peocers-- FROM NOW ON WHEN A "%" KEYSTROKE IS SENT, THE HOST 
prescco-- PROGRAM WILL SEE A FIELD MARK 
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Function Code 9: Query Keyboard ID 


The query keyboard ID function determines the type of 
3278/3279 keyboard attached to the personal computer. 


This function can be used with a display connected to any 
control unit 


Invocation 

AH 9 
Accepted 

CF 0 

AL l 

BX Keyboard ID 


0110 U.S. EBCDIC Typewriter 

0111H U.S. EBCDIC Typewriter — RPQ 
8K0731 

0112H U.S. EBCDIC Typewriter — RPQ 
8K0808 

0113H U.S. EBCDIC Typewriter — RPQ 
8K0932 

0114H U.S. EBCDIC Typewriter — RPQ 
8K 1038 

0120H U.S. Data Entry 

0121H U.S. Data Entry — RPQ 8K0732 

0130H U.S. Data Entry Keypunch 

0140H U.S. EBCDIC Typewriter/APL 

0150H U.S. EBCDIC Typewriter/Text 

0160H U.S. EBCDIC Typewriter — 
Attribute Select 

0170H U.S. EBCDIC Typewriter/APL — 
Attribute Select 

0210H U.S. ASCII Typewriter 


This function is always accepted. 


A-28 Assembler Application Program Interface 


Return Codes 
Table A-2 gives the return codes for each function. 


Table A-2. Function and Return Code 
Cross-Reference 


Return Code 


|RetumCode 
1|2/3/4]5 J6]7|8] 9] 10] 11] 12413 | 


‘Os Set ‘Setmode | 


1 Send ode} + — a — 
: to the keyboard 
interface 

p. Set the 
interrupt vector 
Reset the 
interrupt vector 
Set input 
buffer address 

5 Send a message 
to the 3274 
Cancel message 
to the 3274 


Modify the 
keyboard input 
translation table 


Modify the 
keyboard output: 
translation table 


keyboard ID 


All 
others 


Note: Function AH = 9 will always be accepted with a return 
code = 0. 
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3270 Attachment Interrupt Handler Extension 
Interface 


An application program can specify an interrupt handler exten- 
sion to be called when data is received from the 3274 Control 
Unit. This interrupt handler extension can process data for any 
of the three data flows recognized by the BIOS extension (data 
transfer, screen capture, or wrap test). The same interrupt han- 
dler extension can process data for any combination of data 
flows. 


The interrupt handler extension must be defined as a FAR 
PROCEDURE. It is directly called by the BIOS extension 

and must return to the BIOS extension by issuing a Return 
(RET) instruction. The BIOS extension passes a function code 
to the interrupt handler extension in the AL register. The con- 
tents of other registers are described below. 


The interrupt handler extension modifies 8088 registers except 
the stack segment (SS) and the stack pointer (SP). On entry 

to the interrupt handler, the contents of all registers (except 
those listed below) are unpredictable. Be careful if the interrupt 
handler has any variable with an implied segment attribute. The 
DS register is not guaranteed to point to your variables’ data 
segment. 


When the BIOS extension calls the interrupt handler extension, 
all interrupt levels are enabled. Note that the interrupt handler 
extension receives control as part of interrupt processing. There- 
fore, since IBM Personal Computer DOS does not allow for con- 
current active requests, the interrupt handler extension cannot 
request any DOS functions while it is in control. 


Function Code 1: Message Received from 3274 


This function code indicates a message is received from the 
3274 Control Unit for one of the types of data assigned to this 
interrupt handler extension. If a message is received from the 
3274 Control Unit and no interrupt handler extension is assigned 
to that data type, the message is discarded. 
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Invocation 


AH 1 

AL Flags 
1xxxxxxx Message truncated (Input buffer too small) 
Oxxxxxxx Message not truncated 

CX Length of Input Message 

ES:DX Address of input buffer. (This address was pre- 
viously set by the application program using the 
set 3270 attachment input buffer address function.) 


If the message truncated flag is set, the input buffer specified by 
the application program is too small to contain the entire mes- 
sage received from the 3274 Control Unit. The remainder of 
the message is automatically discarded and cannot be retrieved 
by the interrupt handler extension. 


The input buffer for data transfer message contains one or more 
structured fields sent by a host system application program. See 
Appendix G for the format of the structured fields used by the 
sample file transfer application program. 


The input buffer for a screen capture message contains the con- 
tents of either the display station character buffer, the display 
station extended attribute buffer, or both. The following header 
precedes the contents of each buffer: 


Byte O Byte 1 Byte 2 Byte 3 


e Buffer Length = The number of bytes in the display buffer 
plus 2 (for example, for a 3278 Model 2, 
this will be 1922). 


e Buffer Type = The type of display buffer whose con- 
tents follow. This byte will be OOH for 
the display character buffer or 01H for 
the display extended attribute buffer. 


e Row Length The number of characters currently being 
displayed on each line of the display. 


This value will be 40, 80, or 132. 
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The buffer data that follows the header contains the specified 
display buffer. 


The display’s character buffer contains the internal representa- 
tion of the displayed characters and field attributes. See Tables 
F-5 and F-8 for the internal codes. Note that all characters in a 
nondisplay field are replaced with blanks. 


The display extended attribute buffer contains the internal 
representation of the character attributes. See Table F-9 for the 
internal codes. 


Function Code 2: Power On Reset 


This function code indicates that power-on reset was received 
from the 3274 Control Unit. A power-on reset is generated by 
the 3274 Control Unit when the display is turned off and on, 
when the Test/Normal switch is switched to Test and back to 
Normal, or when the 3274 Control Unit goes through the IML 
procedure. If any of these events occurred before your applica- 
tion program started, your interrupt handler extension may be 
entered immediately with the Power On Reset function code. If 
one of these events occurs while your program is running, your 
interrupt handler extension is also entered. Note that when a 
power-on reset is received from the 3274 Control Unit, the 
BIOS extension invokes all active interrupt handler extensions, 
even if the same interrupt handler is active for more than one 
data flow, and cancels all outstanding send message and send 
keystroke requests. 


Invocation 
AH Z 
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Function Code 3: Message Lost 


This function code indicates that a message was received from 
the 3274 Control Unit when no input buffer was available to 
save the data. An input buffer is not available if the application 
program did not issue the set input buffer address function, if the 
application program issued the set input buffer address function 
specifying the length or address of the input buffer as zero, or 
if the interrupt handler extension is processing a received mes- 
sage, unless aset input buffer address function is issued to specify 
a new input buffer. The message affected is automatically dis- 
carded by the BIOS extension and cannot be retrieved by the 
interrupt handler extension. 


Invocation 


AH 3 
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Example of Sending Keystrokes 


aaa ln ae: DEFINE DATA AREAS 


BUFFER_LENGTH DW BUFFER _END-BUFFER 


BUFFER DB 'THIS IS AN EXAMPLE FOR SEND KEYSTROKES' 
DB 8AH ;ENCODING FOR ENTER KEY 

BUFFER_END EQU $ 

RESET_KEY DB 88H ;ENCODING FOR 3278/3279 RESET KEY 

CLEAR_KEY DB 93H ;ENCODING FOR 3278/3279 CLEAR KEY 


{=S=5S5= DEFINE INTERRUPT HANDLER EXTENSION 


MOV AH, 2 ;FUNCTION = SET INTERRUPT VECTOR 
MOV AL,1 ; FOR SCREEN CAPTURE DATA 

MOV DX,OFFSET INT HANDLER ; ADDRESS OF INTERRUPT HANDLER 
INT 50H 


poeo----- SEND KEYSTROKES TO THE 3278/3279 KEYBOARD INTERFACE 


SEND 

MOV AH,1l ;FUNCTION = SEND KEYSTROKES 
LEA DX, BUFFER ; ADDRESS OF KEYSTROKE BUFFER 
MOV CX, BUFFER_LENGTH * LENGTH OF BUFFER 

INT 50H 

JNC DONE ;KEYSTROKES SENT SUCCESSFULLY 


peaea-S Ss OPERATION REJECTED - TAKE CORRECTIVE ACTION 


ILLEGAL _KEYSTROKE: 
CMP AL,4 ;BUFFER CONTAINS INVALID KEYSTROKE- 
JE ERRORL ; PROGRAMMING ERROR 


POWER_ON_RESET: 
CMP AL,6 ; POWER ON RESET 
JE SEND ; RESEND THE KEYSTROKES 


AID_ PENDING: 


CMP AL,10 ;PREVIOUS ATTENTION STILL PENDING- 
JE SEND ; KEEP TRYING 
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KB_ INHIBITED: 


CMP AL, 11 ;KEYBOARD IS LOCKED- 

JNE KB_LOCKED 

‘CALL RESET ; SEND RESET KEYSTROKE 

JMP SEND ; TRY AGAIN 
KB_LOCKED: 

CMP AL, 12 ;ATTENTION KEY AT END OF MESSAGE- 
JE DONE ; WAS ACCEPTED 


MESSAGE LOST: KEYBOARD BECAME LOCKED- 


; 
CALL RESET ; SEND RESET KEYSTROKE 
CALL CLEAR ; SEND CLEAR KEYSTROKE 
JMP ‘SEND 3 TRY AGAIN 


DONE : 


{aoe cass SEND A RESET KEYSTROKE 


RESET PROC NEAR 


MOV AH,1 

LEA DX, RESET_KEY 
MOV Cx; 2 

INT 50H 

RET 
RESET ENDP 


CLEAR PROC NEAR 


MOV AH,1 ;FUNCTION = SEND KEYSTROKE 
LEA DX ,CLEAR_KEY ; ADDRESS OF CLEAR KEYSTROKE 
MOV Cx,1 

INT 50H 

JNC CLEAR_DONE ;FUNCTION ACCEPTED 

CMP AL, 12 ;CLEAR LOCKED THE KEYBOARD 
JE CLEAR_DONE ; THIS IS NORMAL 

CALL RESET ;OTHER ERROR - RESET THE KEYBOARD 
JMP CLEAR ; AND TRY AGAIN 
CLEAR DONE: 

RET 
CLEAR ENDP 


=== === INTERRUPT HANDLER EXTENSION 


INT_HANDLER PROC FAR 


RET 
INT_HANDLER ENDP 
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Example of Screen Capture 


pe SsSSrS= EXAMPLE OF SCREEN CAPTURE 
;NOTE: THIS EXAMPLE DOES NOT CHECK FOR ALL POSSIBLE RETURN CODES! 


BUFFER_LENGTH DW BUFFER END-BUFFER 

BUFFER LABEL BYTE 

SECTION_LENGTH DW ? ;NUMBER OF BYTES FOLLOWING THIS FIELD 
TYPE DB ? ;BUFFER TYPE (00 = CHARACTER BUFFER) 
ROW_LENGTH DB ? ;ROW LENGTH (40,80, OR 132) 

SCREEN CONTENTS DB 264 DUP (?) ;BUFFER CONTENTS 

BUFFER_END EQU $ 

SCREEN _CAPTURE_PARM DB 80H ;SEND ONLY CHARACTER BUFFER 

SCREEN CAPTURE OFF DB OOH ;RESUME LOCAL COPY FUNCTION 

SCREEN CAPTURE KEY DB 9CH ;KEYSTROKE FOR PRINT SCREEN KEY 
INT_HANDLER PROC FAR ; INTERRUPT HANDLER EXTENSION 


. (PROCESS CAPTURED SCREEN IMAGE) 


RET 
INT_HANDLER ENDP 


prescrcc- SET INTERRUPT VECTOR FOR SCREEN CAPTURE 


MOV -AH,2 ;FUNCTION = SET INTERRUPT VECTOR 
MOV AL,1l ; FOR SCREEN CAPTURE MESSAGES 
LEA DX, INT_HANDLER ; ADDRESS OF INTERRUPT HANDLER 
INT 50H 


(-===2-== SET SCREEN CAPTURE INPUT BUFFER ADDRESS 


MOV AH, 4 ;FUNCTION = SET INPUT BUFFER ADDRESS 
MOV AL,1 ; FOR SCREEN CAPTURE MESSAGES 

LEA DX, BUFFER ; ADDRESS OF INPUT BUFFER 

MOV CX,BUFFER_LENGTH ; LENGTH OF INPUT BUFFER 

INT 50H 


:=SSSe—= REQUEST ONLY THE CHARACTER BUFFER 


SCREEN_PARMS: 


MOV AH,5 ;FUNCTION = SEND MESSAGE 
MOV AL,1l ; SCREEN CAPTURE OPTIONS 
LEA DX,SCREEN CAPTURE _PARM ;OPTION BYTE 

MOV Cx,1 ;l DATA BYTE 

INT 50H 

CMP AL,6 ;POWER ON RESET- 

JE SCREEN _PARMS ; RESEND THE OPTIONS 
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CAPTURE THE FIRST TWO LINES OF THE CURRENT SCREEN 


;FUNCTION = SEND KEYSTROKES 


DX,SCREEN_ CAPTURE KEY ; SEND PRINT SCREEN KEY 


50H 


ERROR_HANDLING 


; 1 KEYSTROKE 


;PROCESS ERROR IF REJECTED 


TERMINATE SCREEN CAPTURE - THE 3274 WILL RESUME NORMAL 
LOCAL COPY PROCESSING IF YOU PRESS THE PRINT SCREEN KEY 


TERMINATE: 


MOV 
MOV 
LEA 
MOV 


CANCEL: 
MOV 
MOV 
INT 


AH,5 ;FUNCTION = SEND MESSAGE 
AL,1 ; SCREEN CAPTURE OPTIONS 
DX,SCREEN_ CAPT OFF ; NO BUFFERS WANTED 

CX; 1 ; 1 BYTE MESSAGE 

50H 

AL,6 ; POWER ON RESET- 
TERMINATE ; RESEND THE OPTION BYTE 


RESET INTERRUPT VECTOR 


;FUNCTION = RESET INTERRUPT VECTOR 
; FOR SCREEN CAPTURE MESSAGES 
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Appendix B. BASIC Application 
Program Interface 


This appendix describes a program that provides an interface between 
a personal computer application program written in beginner’s all- 
purpose symbolic instruction code (BASIC) and the data transfer 
facilities of the IBM 3270 Personal Computer Attachment. (See Fig- 
ure B-1.) 


The data transfer interface provides facilities for selecting the mode 
of the display, sending keystrokes to the display, retrieving the con- 
tents of the screen, and exchanging structured fields with a program 
running in the host. 


BASIC Data 


Application Transfer 
Program Interface 


Figure B-1. Diagram of the BASIC Application Program Interface 
Using the Interface with the BASIC Interpreter 


The data transfer interface is contained in a separately compiled 
module named DT3270B.BIN. This module, which occupies about 
8K bytes of storage, must be loaded by the BASIC application pro- 
gram. The following BASIC statements can be used to load the data 
transfer interface module at the end of available memory: 


' LOAD THE DATA TRANSFER INTERFACE AT THE END 
' OF AVAILABLE MEMORY 

DEF SEG=&H40 

END. MEMORY. SEG=64* (256*PEEK (&H14) +PEEK (&H13) ) 
DT. SEG=END. MEMORY. SEG-&H200 

DEF SEG=DT.SEG 

BLOAD "DT3270B. BIN" ,O 
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The data transfer interface module can actually be loaded anywhere 
in memory that does not conflict with DOS or BASIC. 


The BASIC application program must define numeric variables to 
contain the offsets to the appropriate entry points: 


' DEFINE THE ENTRY POINTS INTO THE BASIC DATA 
' TRANSFER INTERFACE 
OPEN3720=0 
CLOSE3270=5 
MODE3270=10 
WRITE3270=15 
GET3270=20 
INPUT3270=25 
FLUSH3270=30 
WRITEHOST=35 
INPUTHOST=40 
FLUSHHOST=45 


To invoke a function in the data transfer interface, a BASIC applica- 
tion program must ensure that the current segment pointer points to 
the data transfer interface module before it calls the appropriate 
entry point: 


' SWITCH THE DISPLAY STATION TO HOST COMPUTER MODE 
DEF SEG=DT.SEG 

MODE%=0 
“CALL MODE3270 (MODE%,RC%) 


Using the Interface with the BASIC Compiler 


The data transfer interface is contained in a separately compiled 
object file named DT3270B.OBJ. This object file must be linked 
with the compiled BASIC program. The following command can 
be used to combine a BASIC application program named SAMPLE 
with the data transfer interface module: 


LINK SAMPLE+DT3270B; 
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To invoke a function in the data transfer interface, the BASIC appli- 
cation program issues the CALL statement to invoke the appropriate 
function: 


' SWITCH THE DISPLAY TO HOST COMPUTER MODE 
MODE%=0 
CALL MODE3270 (MODE% ,RC%) 


Function: Open I/O Interface 


The open I/O interface function allows I/O to be directed to the dis- 
play or to an application program running in the host. The open I/O 
interface function is automatically invoked by all other functions 
within the data transfer interface except set terminal model. A 
BASIC application program may invoke this function explicitly if 
desired. 


Invocation 
CALL OPEN3270(return.code) 


return.code must be an integer variable 


Accepted 
return.code 0 
Rejected 
return.code 1—Personal Computer 3270 Adapter not 


operational 
Return Code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed or not operational, or 
that the POST for the feature bus interface portion of the adapter 
failed. 
Example 


' INITIALIZE THE DATA TRANSFER FACILITY 
CALL OPEN3270 (RC%) 
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Function: Close I/O Interface 
The close I/O interface function concludes I/O to the display or to 
the host. When you exit from the BASIC interpreter by using the 
SYSTEM command or exit from a compiled BASIC program, the 
close I/O interface function is automatically executed. A BASIC 
application program may explicitly invoke this function at any time 
to terminate all I/O to the display. 

Invocation 
CALL CLOSE3270(return.code) 
return.code must be an integer variable 

Accepted. 
return.code 0 
This function is always accepted. 


Example 


" TERMINATE THE DATA TRANSFER FACILITY 
CALL CLOSE3270 (RC%) 
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Function: Set Terminal Mode 


The set terminal mode function associates the keyboard and the dis- 
play either with the program running in the personal computer or 
with the program running in the host. 


In personal computer mode, the keyboard and the display are asso- 
ciated with a program running on the personal computer. The pro- 
gram receives all keystrokes, and the display shows the image from the 
personal computer display adapter. If you enter the mode switch key 
sequence at the keyboard (ALT and INSERT on most keyboards), the 
display station is switched to host computer mode. 


In host computer mode, the keyboard and the display are associated 
with the host. The 3274 or 3276 control unit receives all keystrokes, 
and the display shows the image from the 3274 or 3276 control unit. 
If you enter the mode switch key sequence at the keyboard, the dis- 
play is switched to personal computer mode. 

Invocation 
CALL MODE3270(mode,return.code) 


mode and return.code must be integer variables 


mode O—Switch to host computer mode 
mode 1—Switch to personal computer mode 
Accepted 
return.code 0 
Rejected 
return.code 3—Invalid mode value 


return code 3 indicates that the mode value was not valid (0 or 1). 


Example 
' SWITCH TO HOST COMPUTER MODE 


MODE%=0 
CALL MODE3270 (MODE%,RC%) 
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Function: Output Keystrokes to Display Station 


The output keystrokes function sends keystrokes to the display as 
if the user were pressing the keys on the actual keyboard. The key- 
strokes are sent at a rate not exceeding 10 keystrokes per second. 


This function automatically invokes the open I/O interface function. 


Invocation 


CALL WRITE3270(keystrokes,return.code) 


keystrokes must be a string variable 
return.code must be an integer variable 


keystrokes 


Accepted | 
return code 

Rejected 
return.code 
return.code 


return.code 


return.code 


String variable containing keystroke encodings. 

See Table A-1. When invoked from a program run- 
ning under the BASIC interpreter, this variable can 
contain from 1 to 255 keystroke encodings. When 
invoked from a compiled BASIC program, this vari- 
able can contain from 1 to 32767 keystroke 
encodings. 


1—IBM Personal Computer 3270 Adapter not 
operational 

4—Invalid keystroke encoding in the message 

5—Keyboard is locked. The message may have been 
partially received by the display station before 
the keyboard became locked. 

6—Power-on Reset received from display station 
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Return code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed or is not operational, 
or that the POST for the feature bus interface portion of the adapter 
failed. 


Return code 4, invalid keystroke encoding, indicates that the string 
variable is null or contains a keystroke encoding that is not valid for 
the type of keyboard attached to the personal computer. Table A-1 
lists all the possible keystroke encodings. However, you may only 
output the encodings that correspond to actual keys on the keyboard 
that you are using. For example, the Typewriter/APL keyboards do 
not have PF13—PF24 keys. Therefore, you cannot output keystroke 
encodings corresponding to PF13—PF24 on a Typewriter/APL 
keyboard. 


Return code 5, keyboard locked, is generated if the message cannot be 
sent to the display. 


e Ifthe keyboard locks because of a previously sent message, the 
message is automatically re-sent until it is accepted. 


e Ifthe keyboard locks because of any other condition, a RESET 
keystroke is sent, followed by the message. If the message is not 
accepted this time, a return code 5 results. 


@ If the keyboard locks during transmission of the message, a 
RESET keystroke is sent, followed by a BACK TAB keystroke, 
followed by the message. If this sequence fails 10 times, return 
code 5 results. 


Return code 6, power on reset, indicates that the display was turned 
off and on, the Test/Normal switch was switched to Test and back to 
Normal, or the 3274 Control Unit went through the IML procedure. 
In this case, the connection to the host was probably lost. The appli- 
cation program should switch to host computer mode to allow the 
user to reestablish the host computer session. 


Example 


" OUTPUT KEYSTROKES TO THE DISPLAY 
BUFFERS="THIS IS AN EXAMPLE FOR OUTPUT KEYSTROKES"+CHRS (&H8A) 
CALL SEND3270 (BUFFERS ,RC%) 
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Function: Read Screen Image 


The read screen image function reads the current host screen image 
from the display into a buffer. After invoking the read screen image 
function, the application program may retrieve the data from this 
buffer by invoking the receive screen image data function. When the 
application program has retrieved all the data it is interested in, the 
program must free the buffer by invoking the flush screen image 
buffer function. 


This function automatically invokes the open I/O interface and flush 
screen image buffer functions. 


Invocation 
CALL GET3270(return.code) 


return.code must be an integer variable 


Accepted 
return.code 0 
Rejected 
return.code 1—IBM Personal Computer 3270 Adapter not 
operational 
return.code 5—Keyboard locked 
return.code 6—Power on reset received from display station 


return.code 7—User pressed the ATTN key 


Return code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed, or is not operational, 
or that the POST for the feature bus interface portion of the adapter 
failed. 


Return code 5, keyboard locked, indicates that the display did not 
accept the print screen keystroke from the personal computer. 
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Return code 7, attention received, indicates that you pressed the 
ATTN key on the keyboard before the screen image was received 
from the 3274 Control Unit. 


Return code 6, power on reset, indicates that the display was turned 
off and on, the Test/Normal switch was switched to Test and back 

to Normal, or the 3274 Control Unit went through the IML procedure. 
In this case, the connection to the host was probably lost. The appli- 
cation program should switch to host computer mode to allow you to 
reestablish the host session. 


Example 
' READ THE CURRENT HOST COMPUTER SCREEN IMAGE 


CALL GET3270 (RC%) 


Function: Receive Screen Image Data 


The receive screen image data function retrieves one line of data from 
the host screen image buffer. This buffer may be empty or may con- 
tain a host screen image that results either when you press the Print 
Screen key on the keyboard or the application program invokes the 
read screen image function. 


This function automatically invokes the open I/O interface function. 
After the application program retrieves all the screen image data it is 
interested in, the program must invoke the flush screen image buffer 


function to make the screen image buffer available to receive more 
data. 
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Invocation 


buffer=SPACE$(132) 
CALL INPUT3270(line length return .code) 
buffer=LEFT $(buffer length) 


line, length, and return.code must be integer variables 
buffer must be a string variable 


line 


buffer 


Accepted 


return.code 
return.code 
buffer 


length 


Integer variable containing the number of the line 
on the screen for which the data is to be retrieved. 
The top line of the screen is line 1. 

String variable containing at least enough characters 
to contain one line of the data from the display 
station. For a 3278 Model 5 display station, the 
variable is 132 characters. For any other 3278 or 
3279 display, the variable is 80 characters. The con- 
tents of this variable will be changed by this func- 
tion. However, because of restrictions imposed by 
BASIC, the number of characters in this variable 
cannot be changed. The application program should 
truncate this variable to the number of characters 
returned in “length” after invoking this function. 


O—Entire line retrieved 

9—Partial line retrieved 

String variable containing the specified line of data 
from the host screen image. 

Integer variable containing the length of the data 
returned. This value will vary from 0 to the current 
display station line width (40, 80, or 132 
characters). 


B-10 BASIC Application Program Interface 


Return code 9, partial line retrieved, indicates that the entire display 
line does not fit in the specified string variable. The application pro- 
gram must initialize the string variable with enough characters to con- 
tain the display line and reinvoke the receive screen image data 
function to retrieve the entire display line. 


Rejected 
return.code 1—IBM Personal Computer 3270 Adapter not 
operational 
return.code 6—Power on reset received from display station 
return.code 8—Screen image buffer is empty 
return.code 12—Invalid line number 


Return code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed or is not operational, 
or that the POST for the Feature Bus interface portion of the adapter 
failed. 


Return code 6, power on reset, indicates that the display was turned 
off and on, the Test/Normal switch was switched to Test and back to 
Normal, or the 3274 Control Unit went through the IML procedure. 
In this case, the connection to the host was probably lost. The appli- 
cation program should switch to host computer mode to allow you to 
reestablish the host computer session. 


Return code 8, screen image buffer empty, indicates that the screen 
image does not contain any data. The application program may 
invoke the read screen image function to obtain a copy of the current 
host screen image, or reinvoke the receive screen image data function 
repeatedly until you press the Print Screen key (when a screen image 
will be received automatically). 
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Return code 12, invalid line number, indicates that the line number 
specified was not between 1 and the number of lines being displayed 
on the screen. 


The data received by the application program will be character encod- 
ings compatible with the personal computer displays. Trailing blanks 
and nulls are removed from the data before it is moved into the speci- 
fied string variable. See Tables F-7 and F-8 for the encodings used by 
this function. 


Example 


' OBTAIN THE CURRENT HOST COMPUTER SCREEN IMAGE 
CALL GET3270 (RC%) 
FOR LINE.NO%=1 TO 24 

BUFFERS=SPACES (132) 

CALL INPUT3270 (LINE. NO%, BUFFERS , LENGTH , RC%) 

IF RC=0 THEN BUFFERS (LINE. NO%) =LEFTS (BUFFERS , LENGTHS) 
NEXT 
CALL FLUSH3270 (RC%) 


Function: Flush Screen Image Buffer 


The flush screen image buffer function clears the screen image input 
buffer and makes it available to receive another screen image. 


This function automatically invokes the open I/O interface function. 
Invocation 
CALL FLUSH3270(return.code) 


return.code must be an integer variable 


B-12 BASIC Application Program Interface 


Accepted 


return.code 0 
Rejected 
return.code 1—IBM Personal Computer 3270 Attachment 


Adapter not operational 

Return code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed or not operational, 
or that the POST for the feature bus interface portion of the adapter 
failed. 

Example 
' CLEAR THE HOST COMPUTER SCREEN IMAGE BUFFER 
CALL FLUSH3270 (RC%) 


Function: Output Data to Host 


The output data function sends a message containing one or more 
structured fields to a program running in the host. 


This function automatically invokes the open I/O interface function. 
This function requires a program running in the host that receives 


structured fields. For example, the PCXFER program sends and 
receives the structured fields specified in Appendix G. 


BASIC Application Program Interface B-13 


Invocation 


CALL WRITEHOST(message ,return.code) 


message must be a string variable 
return.code must be an integer variable 


message String variable containing the structured field(s) 
to be sent to the host. When invoked from a pro- 
gram running under the BASIC interpreter, this 
string may contain from 1 to 255 characters of data. 
When invoked from a compiled BASIC program, 
this string may contain from 1 to 2048 bytes of 


data. 
Accepted 
return.code 0 
Rejected 
return.code 1—IBM Personal Computer 3270 Adapter not 
operational 
return.code 6—Power on reset received from display 
return.code 7—User pressed the ATTN key 
return.code 11—Message length is invalid 


Return code 1, adapter not operational, indicates that the IBM 
Personal Computer 3270 Adapter is not installed or not 
operational, or that the POST for the feature bus interface por- 
tion of the adapter failed. 
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Return code 6, power on reset, indicates that the display was 
turned off and on, the Test/Normal switch was switched to Test 
and back to Normal, or the 3274 Control Unit went through the 
IML procedure. In this case, the connection to the host was 
probably lost. The application program should switch to host 
computer mode to allow you to reestablish the host session. 


Return code 7, attention received, indicates that you pressed the 
ATTN key on the keyboard before the message was sent to the host. 


Return code 11, message length invalid, indicates that the string 
variable is null or contains more then 2048 bytes of data. 


Example 


'" SEND A LISTFILE STRUCTURED FIELD 
' TO THE HOST PROGRAM 


FILENAMES="TEST" 

BUFFERS=CHRS (&HOO) +CHRS (11+LEN (FILENAMES) ) + 
CHRS (&HDO) +CHRS (&H11)+CHRS (&H11)+CHRS (&HO1) + 
CHRS (&HO4) +CHRS (&H40) +CHRS (&H11) +CHRS (&HO3) + 
CHRS (1+LEN (FILENAMES ) ) +F ILENAMES 

CALL SENDHOST (BUFFERS , RC3) 


Function: Receive Data from Host 


The receive data function retrieves structured field data that was 
received from a program running in the host. 


This function automatically invokes the open I/O interface function. 


If the application program wants to discard the remainder of the data 
(without receiving the data), it invokes the flush data buffer function 
to allow another structured field to be received from the host. 


This function requires a program running in the host that sends struc- 


tured fields. For example, the PCXFER program sends the structured 
fields specified in Appendix G. 
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Invocation 


buffer=SPACE$(255) 
CALL INPUTHOST (buffer, length,return.code) 
buffer=LEFT$(buffer length) 


buffer must be a string variable 
length and return.code must be integer variables 


buffer String variable containing the number of characters 
you expect to receive. The contents of this variable 
will be changed by this function. However, because 
of restrictions imposed by BASIC, the number of 
characters contained in this variable cannot be 
changed. The application program should truncate 
this variable to the number of characters returned in 
“length” after invoking this function. 


Accepted 
return.code O—Entire message received 
return.code 9—Partial message received 
buffer String variable containing the structured field(s) 


received from the host. 


Return code 0, entire message received, indicates that the entire mes- 
sage has been received by the application program. 


Return code 9, partial message received, indicates that the entire mes- 
sage does not fit in the specified string variable. The application pro- 
gram must repeatedly issue the receive data function until the return 
code is set to 0 to receive the entire message. 
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Rejected 


return.code 1—IBM Personal Computer 3270 Adapter not 
operational 

return.code 6—Power on reset received from display 

return.code 8—No data waiting 

return.code 10—Message lost 

return.code 11—Message too long 


Return code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed or not operational, 


or that the POST for the feature bus interface portion of the adapter 
failed. 


Return code 6, power on reset, indicates that the display was turned 
off and on, the Test/Normal switch was switched to Test and back to 
Normal, or the 3274 Control Unit went through the IML procedure. 
In this case, the connection to the host was probably lost. The appli- 
cation program should switch to host computer mode to allow the 
user to reestablish the host computer session. 


Return code 8, no data waiting, indicates that no data was received 
from the host. 


Return code 10, message lost, indicates that data was received from the 
host while the application program was processing previous data. The 
second message is discarded. 
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Return code 11, message too long, indicates that the data received 
from the host exceeds 2048 bytes. The entire message is discarded. 


Example 


' RECEIVE A STRUCTURED FIELD FROM A HOST PROGRAM 


RC%=8 
WHILE RC%=8 
RC%=9 : INDEX%=0 
WHILE RC%=9 
INDEX%=INDEX%+1 
BUFFERS (INDEX%) =SPACES (255) 
CALL INPUTHOST (BUFFERS (INDEX%) , LENGTH%, RC%) 
IF RC<>8 THEN BUFFERS (INDEX%) =LEFTS (BUFFERS (INDEX%) , LENGTHS) 


WEND 
WEND 
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Appendix C. PASCAL 
Application Program Interface 


This appendix describes a program that provides an interface between 
a personal computer application program written in PASCAL and the 
data transfer facilities of the IBM 3270 Personal Computer Attach- 
ment. (See Figure C-1.) 


The data transfer interface provides facilities for selecting the mode of 
the display, sending keystrokes to the display, retrieving the contents 
of the display screen, and exchanging structured fields with a program 
running in the host. 


PASCAL Data 


Application Transfer 
Program Interface 


Figure C-1. Diagram of the PASCAL Application Program Interface 
Using the Interface 
The data transfer interface is contained in a separately compiled 
object file called DT3270P.OBJ. This object file must be linked with 
the compiled PASCAL program. The following command can be used 
to combine a PASCAL application program called SAMPLE with the 


data transfer interface module: 


LINK SAMPLE+DT3270P; 
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To invoke any function in the data transfer interface, the PASCAL 
application program must declare all the entry points it wants to use 
as external functions: 


FUNCTION OPEN3270: INTEGER; 


EXTERNAL; 

FUNCTION CLOSE3270: INTEGER; 
EXTERNAL; 

FUNCTION MODE3270 (MODE: INTEGER) : INTEGER; 
EXTERNAL; 


FUNCTION WRITE3270 (VAR KEYSTROKES: LSTRING) : INTEGER; 
EXTERNAL ; 

FUNCTION GET3270: INTEGER; 
EXTERNAL ; 

FUNCTION INPUT3270 (LINE: INTEGER; VAR BUFFER: LSTRING) : INTEGER; 
EXTERNAL ; 

FUNCTION FLUSH3270: INTEGER; 
EXTERNAL; 

FUNCTION WRITEHOST (VAR BUFFER:LSTRING) : INTEGER; 
EXTERNAL; 

FUNCTION INPUTHOST (VAR BUFFER:LSTRING) : INTEGER; 
EXTERNAL; 

FUNCTION FLUSHHOST: INTEGER; 
EXTERNAL; 


To invoke a function in the data transfer interface, the PASCAL appli- 
cation program invokes the appropriate function: 


" SWITCH THE DISPLAY TO HOST COMPUTER MODE 


RC: =MODE3270 (0) ; 
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Function: Open I/O Interface 


The open I/O interface function allows I/O to be directed to the dis- 
play or to an application program running in the host. The open I/O 
interface function is automatically invoked by all other functions in 

the data transfer interface except for set terminal mode. A PASCAL 
application program invokes this function explicitly if desired. 


Declaration 


FUNCTION OPEN3270: INTEGER; 


EXTERNAL ; 
Accepted 
value 0 
Rejected 
value 1—IBM Personal Computer 3270 Adapter 


not operational 
Return code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed or not operational, or 
that the POST for the feature bus interface portion of the adapter 
failed. 
Example 


' INITIALIZE THE DATA TRANSFER FACILITY 


RC :=OPEN3270; 
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Function: Close I/O Interface 
The close I/O interface function concludes I/O to the display or to 
the host. When you exit from the application program, the close 
I/O interface function is automatically executed. A PASCAL appli- 


cation program explicitly invokes this function at any time to ter- 
minate all I/O to the display. 


Declaration 


FUNCTION CLOSE3270: INTEGER; 
EXTERNAL; 


Accepted 

value 0 

This function is always accepted. 
Example 


' TERMINATE THE DATA TRANSFER FACILITY 


RC: =CLOSE3270; 


Function: Set Terminal Mode 
The set terminal mode function associates the keyboard and the dis- 
play either with the program running in the personal computer or 


with the program running in the host. 


In personal computer mode, the keyboard and the display are 


associated with a program running in the personal computer. The pro- 


gram receives all keystrokes, and the display shows the image from the 
personal computer display adapter. If you enter the mode switch key 
sequence at the keyboard (ALT and INSERT on most keyboards), the 
display is switched to host computer mode. 
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In host computer mode, the keyboard and the display are associated 
with the host. The 3274 or 3276 control unit receives all keystrokes, 
and the display shows the image from the 3274 or 3276 control unit. 
If you enter the mode switch key sequence at the keyboard, the dis- 
play is switched to personal computer mode. 


Declaration 


FUNCTION MODE 3270 (mode: INTEGER) : INTEGER; 
EXTERNAL; 


mode may be any integer expression 


mode O—Switch to host computer mode 
mode 1—Switch to personal computer mode 
Accepted 
value 0 
Rejected 
value 3—Invalid mode value 


Return code 3 indicates that the mode value was not valid (0 or 1). 


Example 


* SWITCH TO HOST COMPUTER MODE 


RC :=MODE3270 (0) ; 
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Function: Output Keystrokes to Display 
The output keystrokes function sends keystrokes to the display as if 
the user were pressing the keys on the actual keyboard. The key- 
strokes are sent at a rate not exceeding 10 keystrokes per second. 
This function automatically invokes the open I/O interface function. 


Declaration 


FUNCTION WRITE3270(VAR keystrokes :LSTRING) : INTEGER; 
EXTERNAL; 


keystrokes Lstring variable containing keystroke encodings. 
See Table A-1. This variable may contain from 1 to 
255 keystroke encodings. 


Accepted 
value 0 
Rejected 
value 1—IBM Personal Computer 3270 Adapter not 
operational 
value 4—Invalid keystroke encoding in the message 
value 5—Keyboard is locked. The message might have 
been partially received by the display before the 
keyboard became locked. 
value 6—Power on reset received from display 


Return code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed or not operational, or 
that the POST for the feature bus interface portion of the adapter 
failed. 
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Return code 4, invalid keystroke encoding, indicates that the string 
variable is null or contains a keystroke encoding that is not valid for 
the type of keyboard attached to the personal computer. Table A-1 
lists all the possible keystroke encodings. However, you can only out- 
put the encodings that correspond to actual keys on the keyboard you 
use. For example, the Typewriter/APL keyboards do not have 
PF13—PF24 keys. Therefore, you cannot output keystroke encodings 
corresponding to PF13—PF24 on a Typewriter/APL keyboard. 


Return code 5, keyboard locked, is generated if the message cannot be 
sent to the display station: 


e Ifthe keyboard locks because of a previously sent message, the 
message is automatically re-sent until it is accepted. 


e Ifthe keyboard locks because of any other condition, a RESET 
keystroke is entered, followed by the message. If the message is 
not accepted this time, a return code 5 results. 


e Ifthe keyboard locks during transmission of the message, a 
RESET keystroke is entered, followed by a BACK TAB key- 
stroke, followed by the message. If this sequence fails 10 times, 
return code 5 results. 


Return code 6, power on reset, indicates that the display was turned 
off and on, the Test/Normal switch was switched to Test and back to 
Normal, or the 3274 Control Unit went through the IML procedure. 
In this case, the connection to the host was probably lost. The appli- 
cation program should switch to host computer mode to allow you to 
reestablish the host session. 


Example 
* OUTPUT KEYSTROKES TO THE DISPLAY 


BUFFER:='THIS IS AN EXAMPLE FOR OUTPUT KEYSTROKES ' *CHAR (#8A) ; 
RC:=SEND3270 (BUFFER) 
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Function: Read Screen Image 


The read screen image function reads the current host screen image 
from the display into a buffer. After invoking the read screen image 
function, the application program retrieves the data from this buffer 
by invoking the receive screen image data function. When the appli- 
cation program retrieves all the data it is interested in, it must free 
the buffer by invoking the flush screen image buffer function. 


This function automatically invokes the open I/O interface and flush 
screen image buffer functions. 


Declaration 


FUNCTION FLUSH3270: INTEGER: 


EXTERNAL ; 

Accepted 
value 0 

Rejected 
value 1—IBM Personal Computer 3270 Adapter not 

operational. 

value 5—Keyboard locked 
value 6—Power on reset received from display 
value 7—User pressed the ATTN key 


Return code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed or not operational, or 
that the POST for the feature bus interface portion of the adapter 
failed. 


Return code 5, keyboard locked, indicates that the display did not 
accept the Print Screen keystroke from the personal computer. 


Return code 7, attention received, indicates that you pressed the 


ATTN key on the keyboard before the screen image was received 
from the 3274 Control Unit. 
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Return code 6, power on reset, indicates that the display was turned 
off and on, the Test/Normal switch was switched to Test and back to 
Normal, or the 3274 Control Unit went through the IML procedure. 
In this case, the connection to the host was probably lost. The appli- 
cation program should switch to host computer mode to allow you to 
reestablish the host session. 


Example 


' READ THE CURRENT HOST SCREEN IMAGE 


RC:=GET3270; 


Function: Receive Screen Image Data 


The receive screen image data function retrieves one line of data from 
the host screen image buffer. This buffer may be empty or may con- 
tain a host screen image that results when either the user presses the 
Print Screen key on the keyboard or the application program invokes 
the read screen image function. 


This function automatically invokes the open I/O interface function. 
After the application program retrieves all the screen image data it is 
interested in, the program must invoke the flush screen image buffer 
function to make the screen image buffer available to receive more 
data. 

Declaration 


FUNCTION INPUT3270 (line: INTEGER;VAR buffer:LSTRING) : INTEGER; 
EXTERNAL; 


line Integer expression specifying the number of the line 
on the screen for which the data is to be retrieved. 
The top line of the screen is line 1. 
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Accepted 


value O—Entire line retrieved 
value 9—Partial line retrieved 
buffer Lstring variable set to the specified line of data 


from the host screen image. The length of this vari- 
able will be set to the length of the data returned. 
This value will vary from 0 to the current display 
line width (40, 80, or 132 characters). 


Return code 9, partial line retrieved , indicates that the entire display 
line does not fit in the specified Istring variable. The application pro- 
gram must reinvoke the receive screen image data function witha 
large Istring variable to retrieve the entire display line. 


Rejected 
value 1—IBM Personal Computer 3270 Adapter not 
| operational 
value 6—Power on reset received from display 
value 8—Screen image buffer is empty 
value 12—Invalid line number 


Return code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed or not operational, or 
that the POST for the feature bus interface portion of the adapter 
failed. 


Return code 6, power on reset, indicates that the display was turned 
off and on, the Test/Normal switch was switched to Test and back to 
Normal, or the 3274 Control Unit went through the IML procedure. 
In this case, the connection to the host was probably lost. The appli- 
cation program should switch to host computer mode to allow you to 
reestablish the host session. 
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Return code 8, screen image buffer empty, indicates that the screen 
image buffer does not contain any data. The application program 
may invoke the read screen image function to obtain a copy of the 
current host screen image, or reinvoke the receive screen image data 
function repeatedly until you press the Print Screen key. Then, a 
screen image will be received automatically. 


Return code 12, invalid line number, indicates that the line number 
specified was not between 1 and the number of lines being displayed 
on the screen. 


The data received by the application program will be character encod- 
ings compatible with the personal computer displays. Trailing blanks 
and nulls are removed from the data before it is moved into the 
specified string variable. See Tables F-3 and F-4 for the encodings 
used by this function. 


Example 


" OBTAIN THE CURRENT HOST SCREEN IMAGE 


RC :=GET3270; 
FOR LINE_NO:=1 24 DO 

RC: =INPUT3270 (LINE_NO, BUFFER[LINE_NO1]); 
RC : =F LUSH3270 
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Function: Flush Screen Image Buffer 


The flush screen image buffer function clears the screen image input 
buffer and makes it available to receive another screen image. 


This function automatically invokes the open I/O interface function. 


Declaration 


FUNCTION FLUSH3270: INTEGER; 


EXTERNAL; 
Accepted 
value 0 
Rejected 
value 1—IBM Personal Computer 3270 Adapter not 


operational 
Return code 1, adapter not operational, indicates that the IBM Per- 


sonal Computer 3270 Adapter is not installed or not operational, or 
that the POST for the feature bus interface portion of the adapter failed. 


Example 


" CLEAR THE HOST SCREEN IMAGE BUFFER 


RC :=FLUSH3270; 
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Function: Output Data to Host 


The output data function sends a message containing one or more 
structured fields to a program running in the host. 


This function automatically invokes the open I/O interface function. 


This function requires a program running on the host that receives 
structured fields. For example, the PCXFER program sends and 
receives the structured fields specified in Appendix G. 


Declaration 


FUNCTION WRITEHOST (VAR message:LSTRING) : INTEGER; 


EXTERNAL; 


message 


Accepted 
value 

Rejected 
value 
value 


value 
value 


Lstring variable containing the structured field(s) 
to be sent to the host. This string may contain 
from 1 to 255 characters of data. 


1—IBM Personal Computer 3270 Adapter not 
operational 

6—Power on reset received from display 

7—User pressed the ATTN key 

Message length is invalid 
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Return code 1, adapter not operational, indicates that the IBM Per- 
sonal computer 3270 Adapter is not installed or not operational, or 
that the POST for the feature bus interface portion of the adapter 
failed. 


Return code 6, power on reset, indicates that the display was turned 
off and on, the Test/Normal switch was switched to Test and back to 
Normal, or the 3274 Control Unit went through the IML procedure. 
In this case, the connection to the host was probably lost. The appli- 
cation program should switch to host computer mode to allow you to 
reestablish the host session. 


Return code 7, attention received, indicates that you pressed the 
ATTN key on the keyboard before the message was sent to the host. 


Return code 11, message length invalid, indicates that the string vari- 
able is null. 


Example 


' SEND A LISTFILE STRUCTURED FIELD TO THE HOST PROGRAM 


FILENAME:='TEST'; 

BUFFER := CHAR(#00) *CHAR(11+FILENAME. LEN) * 
CHAR (#D0O) *CHAR (#11) *CHAR (#11) *CHAR (#01) * 
CHAR (#04) *CHAR (#40) *CHAR (#11) *CHAR (#03) * 
CHAR (1+FILENAME. LEN) *FILENAME; 

RC : =SENDHOST (BUFFER) 
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Function: Receive Data from Host 


The receive data function retrieves structured field data that was 
received from a program running in the host. 


This function automatically invokes the open I/O interface function. 
If the application program wants to discard the remainder of the data 
(without receiving it), it can invoke the flush data buffer function to 
allow another structured field to be received from the host. 
This function requires a program running in the host that sends struc- 
tured fields. For example, the PCXFER program sends the structured 
fields specified in Appendix G. 

Declaration 


FUNCTION INPUTHOST (VAR buffer:LSTRING) : INTEGER; 
EXTERNAL; 


Accepted 
value O—Entire message received 
value 9—Partial message received 
buffer Lstring variable set to the structured field(s) 


received from the host. The length of this variable 
will be set to the number of characters received. 


Return code 0, entire message received, indicates that the entire mes- 
sage does not fit in the specified Istring variable. The application pro- 
gram must repeatedly issue the receive data function until the return 
code is set to 0 to receive the entire message. 
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Rejected 


value 1—IBM Personal Computer 3270 Adapter not 
operational 

value 6—Power on reset received from display 

value 8—No data waiting 

value 10—Message lost 

value 11—Message too long 


Return code 1, adapter not operational, indicates that the IBM Per- 
sonal Computer 3270 Adapter is not installed or not operational, or 
that the POST for the feature bus interface portion of the adapter 
failed. 


Return code 6, power on reset, indicates that the display was turned 
off and on, the Test/Normal switch was switched to Test and back to 
Normal, or the 3274 Control Unit went through the IML procedure. 
In this case, the connection to the host was probably lost. The appli- 
cation program should switch to host computer mode to allow you to 
reestablish the host session. 


Return code 8, no data waiting, indicates that no data was received 
from the host. 


Return code 10, message lost, indicates that data was received from 
the host while the application program was processing previous data. 
The second message is discarded. 


Return code 11, message too long, indicates that the data received 
from the host exceeds 2048 bytes. The entire message is discarded. 


Example 


' RECEIVE A STRUCTURED FIELD FROM A HOST PROGRAM 


REPEAT 
INDEX :=0 » 
REPEAT 
INDEX :=INDEX+1; 
RC :=INPUTHOST (BUFFER[ INDEX ]) 
UNTIL RC<>9 
UNTIL RC<>8; 
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Function: Flush Data Buffer 


The flush data buffer function clears the host data buffer and makes it 
available to receive another structured field from the host program. 


This function automatically invokes the open I/O interface function. 
Declaration 


FUNCTION FLUSHHOST: INTEGER; 


EXTERNAL; 
Accepted 
value 0 
Rejected 
value 1—IBM Personal Computer 3270 Adapter not 


operational 
Return code 1, adapter not operational, indicates that the IBM 
Personal Computer 3270 Adapter is not installed or not operational, 
or that the POST for the feature bus interface portion of the adapter 
failed. 
Example 


‘ CLEAR THE HOST DATA BUFFER 
RC :=FLUSHHOST; 
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Appendix D. IBM Personal Computer 3270 
Attachment Option 


The IBM Personal Computer 3270 Attachment Option provides a 
variety of interfaces between the system unit and the host-system- 
connected display station. These interfaces enable the display station 
to communicate either with the system unit or with the host process- 
ing system, and permit data transfers between personal computer and 
host system applications. 


The IBM Personal Computer 3270 Attachment Option contains vari- 
ous control and status registers that are accessible to the personal 
computer (via the Personal Computer I/O channel interface) or to the 
host system (via the 3278/3279 feature bus interface). In addition, a 
256x8-bit buffer on the IBM Personal Computer 3270 Attachment 
Option is accessible to both personal computer and host programs 
(although not simultaneously) for data transfer operations. Another 
portion of the IBM Personal Computer 3270 Attachment Option pro- 
vides a 3278/3279 keyboard interface with either the system unit or 
the display. 


The IBM Personal Computer 3270 Attachment Option also contains 
diagnostic circuitry which allows the testing of the IBM Personal 
Computer 3270 Attachment Option internal buses and control/status 
registers. (These read-write tests can be performed only when the 
IBM Personal Computer 3270 Attachment Option is in diagnostic 
mode, with the feature bus in/out cable removed from the distribu- 
tion box at the rear of the system unit.) 


Figure D-1 is a block diagram of the IBM Personal Computer 3270 
Attachment Option. The IBM Personal Computer interface with the 
IBM Personal Computer 3270 Attachment Option is described under 
the headings “‘Register Descriptions’’ and “‘Operations.”’ 
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Interfaces 


Information about the Personal Computer I/O channel interface is 
provided in the JBM Personal Computer Technical Reference manual 
(6025005). 


All Personal Computer I/O channel interface lines are located at the 
62-pin bottom connector on the IBM Personal Computer 3270 Attach- 
ment Option. All other interface lines are located at the 79-pin D-shell 
connector at the rear of the IBM Personal Computer 3270 Attach- 
ment Option. 


Figures D-2 through D-S illustrate the cable pin connections for the 


IBM Personal Computer 3270 Attachment Option card and the dis- 
tribution box. 
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Figure D-2. 3278/3279 Keyboard Cable Pin Connections 
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Figure D-3. 3278/3279 Feature Bus Cable Pin Connections 
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Figure D-5. IBM Personal Computer 3270 Attachment 79-Pin 
Connector 
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Register Descriptions 


The IBM Personal Computer 3270 Attachment Option registers des- 
cribed here include personal computer and feature-bus-accessible con- 
trol and status registers, the 256x8-bit random access storage (RAM) 
buffer, registers within the keyboard interface module (for example, 
Intel’ 8255), and the diagnostic buffer and register. (See Figure D-1.) 


Personal Computer Addressing of Registers 
These accessible IBM Personal Computer 3270 Attachment Option 
registers and buffers (except the 256x8-bit buffer) reside in personal 


computer processor I/O address space. The 256x8-bit RAM buffer, 
in turn, resides in personal computer memory space. 


‘Trademark of Intel Corporation 
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Following is the personal computer addressing scheme for the 
personal-computer-accessible IBM Personal Computer 3270 Attach- 
ment Option registers and buffers. 


Address (Space) | Personal Computer 
(in hexadecimal) | Register/Buffer Function 


3E0 (1/0) Keyboard Read 
input register (port A 
of Intel 8255 module) 


3E1 (1/0) Keyboard Write 
output register (port B 
of Intel 8255 module) 

3E2 (1/0) Keyboard Read/write 
control register (port C 
of Intel 8255 module) 

3E3 (1/0) Keyboard Write 
command register 
(command port of Intel 
8255 module) 

3E4 (1/0) IBM Personal Computer | Write 
3270 Attachment Option | 

} command register 

3E4 (1/0) IBM Personal Computer | Read 
3270 Attachment Option 
status register | 

| 3E5 (1/0) Keyboard serializer Write 

register 

3ES (1/0) Start op modifier Read 
register 


3E6 (I/O) Diagnostic register — Write 
Feature bus out 

3E6 (I/O) Diagnostic buffer — Read 
Feature bus in 

3E7 (1/0) Diagnostic register — Write 
Feature bus out 

3E7 (I/O) Diagnostic buffer — Read 
Feature bus in 

E4000-E40FF 256x8-bit RAM buffer Read/write 

(MEM) 
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Personal-Computer-Accessible Registers/Buffers 


The following registers/buffers are read from, or written to, only the 
personal computer I/O channel data bus. 


Keyboard Interface Registers 


The IBM Personal Computer 3270 Attachment Option uses the Intel 
8255 programmable peripheral interface module to interface with the 
keyboard, with the display keyboard input socket, and with the ana- 
log switch control. The internal registers within the programmable 
peripheral interface module are referred to herein as J/O ports. Fol- 
lowing is a summary of the keyboard interface assignments for the 
programmable peripheral interface module. 


Port Function 1/O Address 
re _[ 3278/3279 Keyboard Out [361 
an 


C Status and Control 
> [eommans 


Descriptions of the functions of the Intel 8255 internal registers 
follow: 


3278/3279 Keyboard In (Port A, Mode 1 Input Only): Each key- 
board scan code is placed in this register as the key is pressed by the 
operator. An interrupt is generated when the register is loaded. 


3278/3279 Keyboard Out (Port B, Mode I Output Only): Scan code 
written to this register is passed through the keyboard out register to 
the display, as though the keyboard were directly attached to the 
display. 


3278/3279 Status and Control (Port C, Read-Write): This register is 


used to report keyboard status and to provide keyboard and display 
control. 
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Bit assignments for read-only operations (for example, status) are as 


follows: 
ee 
7 X (Don’t care) (Most significant bit) 
Reserved 


exert 


Keyboard data status: 
O = No data available 
1 = Data available 


Port A interrupt: 
O = Interrupt disabled 
1 = Interrupt enabled 


Port A interrupt status: 
0=No IRQ 
1 = IRQ — keyboard data available 


Port B interrupt: 
0 = Disabled 
1 = Enabled 


Port B output buffer status: 
0 = Full 
1 = Empty 
(Least significant bit) Port B 
interrupt status: 
0=NoIRQ 

= IRQ — Display keyboard output 
register available 


a 
Pp 
e 
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Bit assignments for write-only operations (for example, control) are 
as follows: 


(Most significant bit) 

Select buffer image: 

0 = Display personal computer image 
buffer 

1 = Display host computer image buffer 


Select keyboard input: 

O = Select keyboard data when reading 
port A 

1 = Select keyboard ID when reading 
port A 


S| bart e 


Port A interrupt control: 
0 = Disable 
1 = Enable 


[ees 


Port B interrupt control: 
0 = Disable 
1 = Enable 


Port B output buffer status: 
0 = Full 
1 = Empty 


X (Don’t care) | (Least significant bit) 
Reserved 
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3278/3279 Command (Command Port): The Intel 8255 command 
register controls the Host Processor switch and enables/disables inter- 
rupts from the display. 


Listed below are the possible values for the command register: 


Hex 
Value } Command 


No Output Character Available (turns on bit 1, port C) 
Disable Interrupt from Display (turns off bit 2, port C) 
Enable Interrupt from Display (turns on bit 2, port C) 


08 Disable Interrupt from Keyboard (turns off bit 4, port C) 
09 Enable Interrupt from Keyboard (turns on bit 4, port C) 


OE Switch Display to Personal Computer Mode (turns off 
bit 7, port C) 

OF Switch Display to Host Computer Mode (turns on bit 7, 
port C) 


Adapter Command Register 


This 1-byte (that is, 8-bit), write-only register resides at personal com- 
puter I/O address hexadecimal (hex) 3E4. Listed below are the regis- 
ter bit values and their associated command assignments: 


Bits Hex IBM Personal Computer 3270 
7654 3210 | Value | Attachment Option Command 


0000 0000 


Turn off Personal Computer Keyboard Out- 
put Interrupt Flag 


0000 0001 
0000 0010 


Operation Complete 


Operation Complete for Read Sequence 
(3274 can read data from adapter buffer) 


Request Read frotn 3274 


Screen Capture Complete 


0000 0011 
0000 0100 
0000 0101 
0000 0110 


Screen Capture in Process 
Turn Off the IBM Personal Computer Attach- 
ment 3270 Option Diagnostic Mode 


Turn On IBM Personal Computer Attachment 
3270 Option Diagnostic Mode 


0000 0111 
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Bits Hex IBM Personal Computer 3270 
7654 3210 | Value | Attachment Option Command 


0000 1000 Turn Off Keyboard Clicker 
0000 1001 Turn on Keyboard Clicker 


0000 1010 Disable IBM Personal Computer 3270 Attach- 
ment Option Keyboard Out Interface to 
Display 


Enable IBM Personal Computer 3270 Attach- 
ment Option Keyboard Out Interface to 
Display 

IBM Personal Computer 3270 Attachment 
Option Feature Bus Interface Disabled 


IBM Personal Computer 3270 Attachment 
Option Feature Bus Interface Enabled 


0000 1011 


0000 1100 


0000 1101 


0000 1110 Reset Command (same as system reset from 
system unit except does not reset 8255 or 


‘serial port busy’ latches) 


0000 1111 Reserved 
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IBM Personal Computer 3270 Attachment Option Status Register 


This 1-byte, read-only register resides at personal computer I/O address 
hex 3E4. Listed below are the bit assignments for this register: 


Bit 


7 


6 


Description 
(Most significant bit) Reserved (always 0). 


Poll request active. This bit is a 1 when a poll request is 
active. It is reset when the acknowledge for the poll is 
received. 


Display type. This bit is a 1 for a 3278 display and a O for a 
3279 display. 


Personal Computer keyboard output busy. This bit is a 1 
when the keyboard serializer is busy. It is reset when the reg- 
ister becomes available or with personal computer reset. 


Personal Computer keyboard output interrupt. This bit is a 
1 when the keyboard serializer has completed sending a char- 
acter. It is reset by the IBM Personal Computer 3270 Attach- 
ment Option command 00 to OE, or with personal computer 
reset. 


Start op interrupt. This bit is a 1 when the start op modifier 
register has been loaded from ‘feature bus out’. The bit is 
reset when the start op modifier register is read by the per- 
sonal computer or with personal computer reset, or IBM 
Personal Computer 3270 Attachment Option command OE. 


IBM Personal Computer 3270 Attachment Option keyboard- 
out interrupt. This bit is a 1 when the IBM Personal Com- 
puter 3270 Attachment Option keyboard-out register (8255 
port B) is available to accept another character from the per- 
sonal computer data bus. This bit is reset when data is sent 
to the register (via a personal computer command) or by per- 
sonal computer reset. 
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Bit Description 


0 (Least significant bit) Keyboard data avail interrupt. This bit 
is a 1 when the IBM Personal Computer 3270 Attachment 
Option has received a character from the 3278/3279 key- 
board via the keyboard-in register (8255 port A). This bit is 
reset when the data is read from the IBM Personal Computer 
3270 Attachment Option or with personal computer reset. 


Keyboard Serializer Register 


This 1-byte, write-only register resides at personal computer I/O 
address hex 3E5. The data written into this register is serialized and 
sent to the keyboard socket of the Personal Computer system unit. 


Note: Writing into the keyboard serializer sets (to logic 1) the per- 
sonal computer keyboard output busy (bit 4) of the IBM Personal 
Computer 3270 Attachment Option status register. When serializa- 
tion is completed, bit 4 is reset (to logic 0) and bit 3 (Personal Com- 
puter keyboard output interrupt) of that register is set. 


Data is sent from the keyboard serializer as follows: first, a parity bit 
(always 1) is sent; next, data is sent starting with the least significant 
bit, followed by the next least significant bit, etc..... up to the most 
significant bit data bit. 


The keyboard serializer also responds to a reset command from the 
IBM Personal Computer keyboard port. The command is X‘FF’; the 
response is X‘AA’. Then, Interrupt IRQ 2 turns on with status regis- 
ter bit 3 on. 


Start Op Modifier Register 


This 1-byte, read-only register resides at personal computer I/O address 
hex 3ES. This register is used to pass control information between 
the 3274 Control Unit and the personal computer during data trans- 
fers. This register is loaded from ‘feature bus out’ with a Start On 
command. 


Note: Loading this register sets bit 2 (Start Op Interrupt) of the IBM 


Personal Computer 3270 Attachment Option status register. That bit 
is reset when the personal computer reads the start op modifier register. 
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Listed below are the register bit values for the start op modifier 


register. 
Bits Hex IBM Personal Computer 3270 
7654 3210 Value Attachment Option Command 
0000 0000 Reserved 
0000 0001 Display Power On Reset 
0000 0010 Read Operation 
0000 0011 Write Operation 
0000 0100 Execute 
0000 0101 Abort Transfer 
0000 0110 Abort to Last Verify 
0000 0111 Error 
0000 1000 Verify Data 
0000 1001 Reserved 
0000 1010 Reserved 
0000 1011 Reserved 
0000 1100 Reserved 
0000 1101 Reserved 
0000 1110 Reserved 


0000 1111 Reserved 


IBM Personal Computer 3270 Attachment Option Diagnostic Register 


This 15-bit-wide register can be written to by the personal computer 
only when the IBM Personal Computer 3270 Attachment Option is in 
diagnostic mode. 


Note: The diagnostic register can be accessed only in IBM Personal 
Computer 3270 Attachment Option diagnostic mode, with the feature 
bus in/out cable removed from the distribution box attached to the 
rear of the system unit. 
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The lines driven by the diagnostic register at personal computer I/O 
address hex 3E6 are: 


Feature Bus Out bit 10 
Feature Bus Out bit 11 
Strobe Feature Bus Out 
Acknowledge 

Reset 

Present Poll 

FBO Poll Request 
Reserved 


ae: 
7 
6 
5 
4 
3 
2 
] 
0 


The lines driven by the diagnostic register at personal computer I/O 
address hex 3E7 are: 


Feature Bus Out bit 2 
Feature Bus Out bit 3 
Feature Bus Out bit 4 


Feature Bus Out bit 5 
Feature Bus Out bit 6 
Feature Bus Out bit 7 
Feature Bus Out bit 8 
Feature Bus Out bit 9 


Or NWR N ON ~ 2 


IBM Personal Computer 3270 Attachment Option Diagnostic Buffer 


The diagnostic buffer receives nine lines from the IBM Personal Com- 
puter 3270 Attachment Option ‘feature bus in’, and three feature con- 
trol lines. 


Note: The diagnostic buffer can be accessed only in the IBM Personal 


Computer 3270 Attachment Option diagnostic mode, with the feature 
bus in/out cable removed from the distribution box. 
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These are the lines that are read from personal computer I/O address 
hex 3E6: 


Bit Function 


7 Feature Bus In bit 10 
6 Feature Response 
5 Poll Request 
| 4 Analog Switch Control 
3 Reserved 
2 Reserved 
1 Reserved 
0 


Reserved 


These are the lines that are read from personal computer I/O address 
hex 3E7: 


Feature Bus In bit 2 
Feature Bus In bit 3 
Feature Bus In bit 4 
Feature Bus In bit 5 
Feature Bus In bit 6 
Feature Bus In bit 7 
Feature Bus In bit 8 
Feature Bus In bit 9 


7 
6 
5 

| 4 
3 
2 

11 
0 


IBM Personal Computer 3270 Attachment Option RAM Buffer 


~ Resident on the IBM Personal Computer 3270 Attachment Option is 
a 256x8-bit RAM buffer. It resides in the personal computer memory 
address space, starting at the base address of hex E4000. The buffer 
can be written to or read from either by the personal computer or by 
a Feature Bus command, but not simultaneously. The personal com- 
puter may access the buffer only from the time the IBM Personal 
Computer 3270 Attachment Option receives a Start Op command 
until the personal computer responds with an Operation Complete 
hex 01 and Operation Complete for Read hex 02 command. If the 
personal computer violates this restriction, the contents of the buffer 
will not be modified, and the personal computer will NOT be informed 
of the violation. The data that was read will be invalid, and the data 
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written ignored, if the personal computer was doing a write-memory 
operation. The only other time that the personal computer has access 
to the RAM buffer is when the ‘feature bus interface enabled’ latch 
has been reset. At all other times, the buffer is dedicated to the fea- 
ture bus. 


Operations 


Keyboard In 


This function interfaces the keyboard with the personal computer. 
The interface is asynchronous in that when the keyboard has a char- 
acter to send it activates the ‘data avail’ line. The keyboard expects 
an. acknowledgment from the personal computer. If another key is 
pressed on the keyboard before the first one is read in, the keyboard 
will buffer the second character. The keyboard contains a 2-character 
buffer. If the buffer overflows, the keyboard forces the overrun scan 
code (hex 00) into the keyboard buffer. The scan code for the key 
pressed is valid from the keyboard under the ‘data avail’ window. 


The Intel 8255 module is the main device used to interface with the 
keyboard. In the initialization program it has been first set to read 
the keyboard ID. This ID is a 4-bit code that tells the software which 
type of keyboard is attached. 


For normal operation after initialization, the 8255 port A is set up for 
strobed input. When the ‘data avail’ line from the keyboard becomes 
active, the eight scan bits are loaded into the 8255. The 8255 responds 
by activating the ‘Kb ack’ line. A pulse synchronizer is used to ensure 
that the maximum length of the ‘Kb ack’ line is only 420 nanoseconds 
(ns). When the software reads port A of the 8255, the ‘data avail’ line 
from the 8255 is deactivated. If a second key is pressed before the 
8255 has been read, the strobe line to the 8255 is blocked and 

‘Kb ack’ withheld. In this way, the keyboard buffers the keystrokes. 
The 8255 also generates an interrupt to the personal computer 

when a character has been read into the 8255. 


The clicker line from the display is either passed through to the key- 


board in host computer mode or controlled by a command in the per- 
sonal computer software in personal computer mode. 
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Keyboard Out 


This interface sends keystrokes from the personal computer to the dis- 
play and is fully asynchronous. Port B of the 8255 is used in strobed 
output mode to send data to the display. After a character is loaded 
into the 8255, the 8255 activates the ‘data avail out’ line. The display 
responds by activating ‘Kb ack out’ and deactivating ‘data avail out’, 
causing the 8255 to activate the interrupt request. This interrupt sig- 
nals that the 8255 is available to receive more data. 


To avoid sending erroneous data to the display during IPL and recon- 
figuration of the 8255, the “data avail out’ line is gated with the dis- 
play gate latch. When the latch is set, data is enabled to be sent to the 
display. 


Keyboard Serializer 


The keyboard serializer formats the keyboard data to be sent to the 
personal computer. After a keystroke has been read in from the 
3278/3279 keyboard, the personal computer software determines 
where to send the data. If the display station is in personal computer 
mode, the keystroke is mapped by the software to a corresponding 
personal computer keyboard scan code. Next, the new scan code is 
sent to the keyboard serializer. When a character is sent to the serial- 
izer, the personal computer Kbd Output Busy bit becomes active in 
the IBM Personal Computer 3270 Attachment Option status register. 
The data is serialized as follows. First, a 1 bit is sent. Next, the eight 
data bits are sent with the least significant bit first. Finally, after all 
the bits have been sent, the personal computer Kbd Output Busy bit 
is reset and the personal computer Kbd Output Interrupt bit in that 
register becomes set. 


Feature Command, Decode and Execution 


The IBM Personal Computer 3270 Attachment Option interfaces with 
3278/3279 feature bus to enable the transfer of data between the 
personal computer and the display. The interface contains two uni- 
directional buses and various control lines. Commands and data are 
sent to the IBM Personal Computer 3270 Attachment Option over 
3278/3279 Feature Bus Out, and data is sent to the display over 
3278/3279 Feature Bus In. 
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Commands are sent to the IBM Personal Computer 3270 Attach- 
ment Option in the following manner: 


1. The IBM Personal Computer 3270 Attachment Option address 
and command are placed on “feature bus out’. 


2. The display activates the ‘-strobe FBO’. 


3. The IBM Personal Computer 3270 Attachment Option checks 
for address hex 5, and checks whether the command is valid and 
the parity good. 


4. The IBM Personal Computer 3270 Attachment Option responds 
with ‘-feature response’ if the above conditions are met. If the 
conditions are not met, the display will time out because the IBM 

- Personal Computer 3270 Attachment Option did not respond. 


5. The command is executed by the IBM Personal Computer 3270 
Attachment Option. 


a. Ifthe command is a read type, the IBM Personal Computer 
3270 Attachment Option places the appropriate data on 
‘feature bus in’. For a multibyte read, up to four bytes of 
data are sent, depending on the two low-order bits in the 
BAR. 


b. If the command is a write type, the IBM Personal Computer 
3270 Attachment Option stores the data from ‘feature bus 
out’ in the appropriate RAM buffer location. The display 
responds with additional ‘strobe FBO’ lines for each byte to 
be transferred. Data parity is always checked. 


Logic Diagrams 


Figures D-6 through D-22 show the logic for the IBM Personal Com- 
puter 3270 Adapter. 
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Figure D-6. Personal Computer Adapter (Personal Computer I/O PG A001) 
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Figure D-7. Personal Computer Adapter (Keyboard and Feature Bus PG A002) 
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Figure D-8. Personal Computer Adapter (Redrive and Diagnostic PG A003) 
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Figure D-9. Personal Computer Adapter (Keystroke I/O Ports PG A004) | 
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Figure D-10. Personal Computer Adapter (Memory and I/O Address PG A005) 
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Figure D-11. Personal Computer Adapter (Keyboard Serializer PG A006) 
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Figure D-12. Personal Computer Adapter (Feature Bus Receivers and Drivers PG A007) 
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Figure D-13. Personal Computer Adapter (Command Decode Feature Response PG A008) 
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Figure D-14. Personal Computer Adapter (Status ID and Poll Response PG A009) 
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Figure D-15. Personal Computer Adapter (RAM Control PG A010) | 
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Figure D-16. Personal Computer Adapter (Feature Bus Command Decode PG A011) 


U95 
Z Le 74LS32 
eee ow sige 
oe ee bf 8 
| Uy 


U.10 
74LS173 


U71 U59 
74LS32 74LS04 


e 
U11 


74LS138 


U20 
74LS$138 


U08 
74LS00 


12 74LS00 


EDs 


U91 
74LS00 


1 
5 


U91 
S00 


+START OP SET PG A009,13 


+SET START OP MOD PG A013 


| 


-IDLE COMMAND (0) PG A008 


-PO 


LL.COMMAND (1) PG A007,9,10 


-RESET COMMAND (2) PG A014 
-READ DATA COMMAND (3) PG A010,15 


~READ ID (W/O PC) CMD (5) PG A009,10 
-WRITE ADR LO CMD (6) PG A012 
-READ ID (PC) CMD (7) PG A009,10 


-START OP CMD (8) 

-CMD DEC (9) PG A008 

-CMD DEC (A) PG A008 

-READ MPL CMD (B) PG A008,10,15 


-W 


ITE DATA CMD (C) PG A010,15 


-CMD DEC (D) PG A008 
-CMD DEC (E) PG A008 
-READ STATUS CMD (F) PG A009,10 


3270 Attachment Option D-33 


U49 
U29 74LS74 


74802 1 10 
PG A007 — PRESET POLL INT Ls 13 PR 9 
5 , CK a +POLL REQUEST PG A011,13 
= D 
B 


U37 


PG A017 + TIEUP 4 


, U88 74LS74 a Lee POLL REQUEST PG A009,15 
+OP COMPLETE PENDING 11 7425 
ee +IPL COMPLETE INTERRUPT —_0 3 
+READ REQUEST SEQUENCE INTERRUPT —12 ° - RESET POLL REQUEST PG A009 
+T/F SCREEN CAPTURE BUSY INT 


PG A010 — FEATURE BUS ADAPTER RESET 


74LS00 


PG A007 — ACKNOWLEDGE INT 


74LS08 
+G BUS BIT 1 
+G BUS BIT 2 +2 n_12 12 
PG A007, 09 oo GUS Gita se ee D +POLL CMD DECODED PG A011 
! 


| U15 | ie 
74LS04 | 
PG A015 — STROBE FEATURE OUT : : ! 74LS08 
PG A015 — L2 fms as 2 +GATE STORED FEATURE BUSS OUT PG A011 
U82 
5 14us32 U95 


j 74LS32 
a 11 9 és 
PG A007 + COMMAND 10 ce -LOAD BAR PG A014 


PG A011 — WRITE ADR LO CMD (6) 


Figure D-17. Personal Computer Adapter (Poll Request PG A012) 


D-34 3270 Attachment Option 


+G BUS BIT 7 


PG A007,9 


NO © fh Ol MD 


1 
+G BUS BIT O 


PG A011 + SET START OP MOD 


PG A010 + POLL REQUEST 


+ 3278 PG A002,17 
PG A006 + SERIAL PORT BUSY 


PG A006 + SERIAL PORT INTERRUPT 


PG A004 + PARALLEL OUT INTERRUPT 
PG A004 + KEYBOARD IN INTERRUPT 
PG A017 + TIEUP 4 


PG A011 + START OP SET 


PG A005 -- ADR 3E4 (STATUS/COMMAND) 


PG A003 — IOR INT 

PG A005 — ADR 3E5 (START 
OP/KEYBOARD SERIAL) 

PG A010 — FEATURE BUS ADAPTER RESET 
PG A009 + BUSY 

PG AOQO9 — IPL COMPLETE 


START OP MOD 
U50 
74LS374 


PC STATUS 
U75 
74LS244 


Figure D-18. Personal Computer Adapter (Start OP, MOD, and Personal Computer Status PG A013) 
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Figure D-19. Personal Computer Adapter (RAM BAR Counter Address Select PG A014) 


D-36 3270 Attachment Option | 


U18 
74LS04 


PG A003 + PC CLK INT “lF>o+ 


PG A017 + TIEUP 


U19 
i294 vateia 
bD PR abe 


PG A002,17 + LO L1 L2 TEST POINT 


~ READ DATA COMMAND (3) 
PG A001 
| ~ READ MPL CMD (B) a = 
~WRITE DATA CMD (C) 4 ry 74LS08 
PG AOO7 + COMMAND 3) A 
74LS02 ea 
PG A009 - IPL COMPLETE F , 
PG A012 - POLL REQ 8 ia 
PG A007 - FEATURE BUS IN BIT 10 (PARITY) (Cn i aes 
PG A017 - STROBE FEATURE BUS OUT = aes 
PG A008 - FEATURE RESPONSE INT es 
PG A009 - GATE j 
PG A010 + READ OR REAL MULTIPLE COMMAND | 12 a 
U13 i 
74LS244 


PG A002,16,17 - FEATURE BUS OUT BIT 10 
PG A004 - DATA AVAILABLE INT 

PG A004 - KEYBOARD ACKNOWLEDGE INT 
PG A004 - CLICKER INT 


U44 


PG A002 - DATA AVAIL 
PG A002.4 - KB ACKNOWLEDGE 
PG A002 - CLICKER 


PG A003 - PC POWER OFF 


@ KEYBOARD POWERED 


Figure D-20. Personal Computer Adapter (LO, L2, Latches PG A015) 
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Appendix E. Setup for Data Transfer 


The host, the IBM 3274 Control Unit, and the Personal Computer all 
require preparation for the data transfer sample application pro- 
grams. Table E-1 outlines data transfer needs. 


Table E-1. Data Transfer Requirements 


Screen Capture File Transfer 
Machine Requirements Requirements 


3274 1. Configuration C Same as for screen 
Control (release 46 or capture 

Unit higher) or 
configuration D 
(release 60 or 


higher) 


Customization for 
the IBM 3270 

Personal Computer 
Attachment 


Same as for screen 
capture 


IBM 
Personal 
Computer 


1. System disk (DOS 
1.1 or 2.0) 


2. Disk with 
HOST.EXE file 


System unit with 
128K bytes 
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Table E-1. Data Transfer Requirements 
(continued ) 


Screen Capture File Transfer 
Machine Requirements Requirements 


1. Ifthe IBM 3278 
does not have an 
extended character 
set adapter (FC 
3610 or FC 3620), 
or if the 3279 
does not have the 
extended function 
(FC 3850), then 
Service Level 206 
(PUT 8305) must 
be installed on 
VM/SP. 


Host None 
Computer 


(CMS) 


Access to 
PCXFER MODULE, 
PROFILE PCXFER, 
PCXFER EXEC. 
Optional Access to 
PCXFER MACLIB, 
ISPF 5668-960 

(for menus), 
ISPF/PDF 
5664-172, and 
PCXFER HELPCMS 
(for information). 
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Table E-1. Data Transfer Requirements 


(continued ) 
Screen Capture File Transfer 
Machine Requirements Requirements 
None 1. TSO with 


ACF/VTAM, 
Release 1.3, or 
TSO with 
ACF/TCAM, 
Release 2.4, PTF 
# UZ90256, 
UZ90257, 
UZ90258 (APAR 
# O0Z69872), 
PTF # UZ67877 
(APAR 

# OZ73530). 


Access to 
PCXFER.CLIST, 
PCXFER.LOAD, 
PCXFER.PROFILE. 
Optional access to 
PCXFER.PANEL, 
ISPF 5668-960 
(for menus), 
ISPF/PDF 
5664-268, and 
PCXFER.HELP 
(for information). 
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Customizing the Control Unit for Data Transfer 


Look in the left side of the operator information area (OIA) to see 
what type of control unit your display station is attached to. Try to 
match one of the symbols below: 


Symbol Meaning 

A or B IBM 3274 Control Unit 

[co}4 or [o}e IBM 3276 Control Unit 
Display Station 

I4 or IB IBM Integrated Display 
Adapter 


If your display station is not attached to a 3274 Control Unit, you 
cannot do screen capture or file transfer. 


If your display station is attached to a 3274 Control Unit, how do 
you know if it is customized? Type in HOST while in personal com- 
puter mode. Two copyrights appear on the screen, and then the 
screen switches to host computer mode. If this does not happen, your 
control unit might not be customized. 


Remember, your 3274 Control Unit must have Configuration C 
(Release 46 or higher) or Configuration D (Release 60 or higher) to 
support data transfer. Refer to the JBM 3274 Control Unit Planning, 
Setup, and Customizing Guide, GA27-2824, for customization 
information. 
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Preparing the Personal Computer for Data 
Transfer 


HOST.EXE, the Personal Computer data transfer application pro- 
gram, comes on the customization diskette with this book. For 
convenience, you might copy HOST.EXE onto your daily applica- 
tion disk. Then, you won’t need to keep shuffling diskettes. 


Remember, screen capture to the Personal Computer printer is similar 
to the 3270 local-copy function and to the IBM Personal Computer 
print-screen function. However, the 3270 host-initiated local-copy 
function is not supported for hard-copy output to the IBM Personal 
Computer printer. 


Uploading the CMS File Transfer Sample 
Application Programs 


To prepare the CMS host, the sample application programs must be 
sent to the host from the IBM Personal Computer Attachment Option 
data transfer diskette. 


To check whether the application programs are already uploaded, 
type in HELP PCXFER. A help panel is displayed on the screen. If 
no panel appears, you need to upload the application programs. 


CMS Requirements 


Your CMS host must use VM/SP, Release 1.0 (or later), for the file 
transfer sample application programs to work. Structured fields must 
be supported by your console. Structured fields are supported if you 
have an ECSA card installed in your display or if VM service level 
#206 PUT 8305 has been installed in your VM system. 
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VCNA Requirements 


If you have VCNA, the LOGMODE table must specify EXTENDED 
HIGHLIGHTING. You do this by setting byte 1 (zero reference) of 
the PSERVIC entry for the display to X‘COQ’. Other fields for the 
LOGMODE table should be specified as described in Chapter 3 of 
the VM/VCNA: Installation, Operation and Use manual, SC27-0502. 


Note: This change specifies that your display has an ECSA feature. 
If your 3278 does not have an ECSA feature, programs that require 
the feature will cause a PROG error at the display. Either the session 
will be disconnected from VM or the application will receive an error 
message. If the session is disconnected, the user may reconnect it by 
using a LOGMODE table with byte 1 of the PSERVIC entry set to 
X‘40’, 


Since VCNA uses VTAM as its communication link, certain VTAM 
requirements apply for VCNA. If VTAM uses BSC, the VTAM system 
definition data set (SYS1.VTAMLST) must specify that BSC trans- 
parency is to be used when sending data to the display. You can do 
this by specifying the ‘EDATS’ value for the FEATUR2 keyword on 
the TERMINAL macro describing the display containing the IBM 
3270 Personal Computer Attachment. For example: 


NK32A311 TERMINAL ADDR=60604040, 
POLL=40404040 DLOGMOD=T3278M2, 
FEATUR2=EDATS 


Contact the person responsible for maintaining your ACF/VTAM 
system data sets to ensure that these changes are properly specified 
and that the NCP is reactivated with the updated system definition. 


Note: The FEATUR2=EDATS keyword is used only by VTAM, not 
by the NCP. Therefore, changing this keyword in the VTAM system 
definition data set does not require rerunning the NCP SYSGEN 
procedure and does not require reloading the NCP load module. 
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UPLOAD Program Requirements for CMS 


Before you upload, you must check to make sure your host exe- 
cutes the commands in the upload program. The UPLOAD program 
issues the following CMS commands: 


ERASE fn ft A 

(which must be an ERASE MODULE, not an EXEC) 
XEDIT fn ft A (NOPROFILE 

XEDIT fn ft A (PROFILE macroname 

SET BLIP OFF 

SET MSG OFF 

SET WNG OFF 

SET EMSG OFF 

SET IMSG OFF 

SET LINEDIT OFF 


These commands must function exactly as specified in these manuals: 


e IBM Virtual Machine/System Product: CMS Command and 
Macro Reference, SC19-6209 


e JBM Virtual Machine/System Product: CP Command Reference 
for General Users, SC19-6211. 


Otherwise, you might not be able to install the file transfer sample 
application program on your CMS host. 


In addition, UPLOAD creates the EXEC2 EXECs PCXFBOOT and 
PCXFER. The UPLOAD program and the file transfer sample appli- 
cation program will not run unless your CMS supports EXEC2 EXECs. 
The PCXFBOOT EXEC and the PCXFER EXEC issue the following 
EXEC commands: 


&TRACE OFF 

&TRACE ERR 

* comment 

&exec variable = &exec variable 

&IF word1 = word2 executable-statement 
&TYPE word! word? ... 

&GOTO label 

&BEGTYPE n 

&READ ARGS 

&EXIT return-code 
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Your EXEC2 EXEC processor must execute these statements exactly 
as specified in JBM Virtual Machine/System Product: EXEC2 Refer- 
ence, SC24-5219. The CMS EXEC2 processor must support the 
&RETCODE and &ARGSTRING variables. Otherwise, you might 
not be able to install the file transfer sample application program on 
your CMS host. 


The PCXFBOOT EXEC and the PCXFER EXEC issue the following 
CMS commands: 


ERASE fn ft A (which must be an ERASE MODULE, 
not an EXEC) 

GLOBAL MACLIB libnamel1 libname2 

GLOBAL TXTLIB libname1 libname2 

ASSEMBLE fn 

LOAD fn (START 

MACLIB GEN libname fnl fn2 fn3 fn4 

EXEC fn args 

CP SET options 


The EXECs must execute these commands exactly as specified in the 
following manuals: 


e IBM Virtual Machine/System Product: CMS Command and 
Macro Reference, SC19-6209 


e IBM Virtual Machine/System Product: CP Command Reference 
for General Users, SC19-6211. 


Otherwise, you cannot install the file transfer sample application 


program on your CMS host. Refer to the HELPME.CMS file on the 
CMS data transfer diskette for more information. 
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CMS Upload Procedure 


If your CMS host will execute all the commands issued by the 
UPLOAD program, follow the procedure in Table E-2 to upload the 
file transfer sample application programs. 


Table E-2. CMS Upload Procedure 


User Action Computer Response | 


In host computer mode, make 
sure you: 


1. Logonto CMS. 
2. IPLCMS. 


3. Can issue CMS 
commands. 


Skip this step if you have 
already done this. 


Check to see if the If you receive an error message, 
programs are already the host is not customized. 
uploaded. Enter HELP Continue with this procedure. 
PCXFER (Skip this step 

if you have already checked.) 


If you are not in personal 
computer mode, switch 
over to it. 


For backup, make a 
DISKCOPY of the data 
transfer diskette. (Skip 
this step if you have 
already made backup 
copies.) 
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Table E-2. CMS Upload Procedure 
(continued ) 


User Action Computer Response 


os Za 


VM/CMS diskette. (Make 
The customization process 


sure the diskette does not 

have a write protect tab on 

it, since a checkpoint file is 

written to the diskette.) 
begins. If you do not receive 
any status messages within 15 
minutes, refer to the HELPME 
file on the supplied diskettes. 

Allow at least 1-1/2 hours for 

this uploading process. 


Type UPLOAD CMS 
Press ENTER 


If you want to stop the 
UPLOAD program once 

files start to be sent to the 
host, press the ATTN key 
repeatedly. 


If you have problems 
with this book. 


uploading, refer to the 
HELPME.CMS file 
supplied in the diskette 


Customization completion 
message. 
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Upload Error Messages for CMS 


@ <A 2% % appears in the operator information area if your 3274 
Control Unit is not customized. 


eo «A NN 69 in the operator information area means that your dis- 
play station is attached to a 3276 Control Unit, which does not 
support data transfer. 


e If nothing happens, and I 4 or I 8 is displayed in the left of the 
operator information area, your display station is attached to an 
integrated display adapter (IDA). The IDA does not support 
data transfer functions for the IBM 3270 Personal Computer 
Attachment. See your supervisor or system programmer. 


e Restart the customization process if your host session is inter- 
rupted. The customization resumes as close as possible to the 
point of interruption. 


e If you receive error messages or your customization is not com- 
pleted successfully, see the HELPME file on the diskettes sup- 
plied with this book. You might want a hard copy if you have 
access to a printer. If not, enter TYPE HELPME.CMS. Then, 
press the DUP key to stop the file from scrolling. 
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Uploading the TSO File Transfer Sample 
Application Programs 


To prepare the TSO host, the sample application programs must be 
sent to the host from the IBM Personal Computer Attachment 
Option data transfer diskette. 


To check whether the application programs are already uploaded, 
type in EX PCXFER. Ifa message “data set PCXFER.CLIST not 
in catalog” appears, you need to upload the application programs. 


TSO Requirements 


Your TSO host must use ACF/VTAM Version 2, Release 1 (or later), 
for the TSO file transfer sample application program to work. 


Note: If your TSO host is using ACF/TCAM to communicate with 
the display, the file transfer sample application program cannot be 
used. 


If VTAM uses BSC, the VIT'AM system definition data set 
(SYS1.VTAMLST) must specify that BSC transparency is to be used 
when sending data to the display. You can do this by specifying the 
‘EDATS’ value for the FEATUR2 keyword on the TERMINAL macro 
describing the display containing the IBM 3270 Personal Computer 
Attachment. For example: 


NK32A311 TERMINAL ADDR=60604040, 
POLL=40404040 .DDLOGMOD=T3278M2, 
FEATUR2=EDATS 


Contact the person responsible for maintaining your ACF/VTAM 
system data sets to ensure that these changes are properly specified 
and that the NCP is reactivated with the updated system definition. 


Note: The FEATUR2=EDATS keyword is used only by VTAM, not 
by the NCP. Therefore, changing this keyword in the VITAM system 
definition data set does not require rerunning the NCP SYSGEN pro- 
cedure and does not require reloading the NCP load module. 
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UPLOAD Program Requirements for TSO 


Before you upload, you must check to make sure your host executes 
the commands in the upload program. 


The upload program issues the following TSO commands: 


PROF NOCHAR NOLINE NOINTERCOM NOWTPMSG 
DELETE (data-set-name) PURGE 
EDIT data-set-name NEW NONUM BLKSIZE (3120) 


These commands must function exactly as specified in OS/VS2 TSO 
Command Language Reference, GC28-0646. Otherwise, you might 
not be able to install the file transfer sample application program on 
your TSO host. 


The PCXFBOOT command list issues the following TSO command 
procedure statements: 


PROC O DEBUG 
CONTROL options 

IF condition THEN statement 
WRITE text 

ERROR OFF | statement 
DO ... END 

SET variable=value 
GOTO label 

WRITENR text 

READ variable 

EXIT CODE(value) 


The TSO host should execute these statements exactly as specified in 
OS/VS2 TSO Command Language Reference, GC28-0646. Otherwise, 
the PCXFBOOT command list cannot work. 

If your PCXFBOOT command list fails: 

1. Edit the PCXFBOOT.CLIST data set. 


2. Change the commands to your TSO system commands. 


3. Rerun the PCXFBOOT command list. 
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The PCXFBOOT command list issues the following TSO commands: 


PROFILE PAUSE 

DELETE (data-set-name-list) PURGE 

ASM data-set-name NOTERMINAL 

LINK data-set-name 

ATTRIB 

ALLOC 

CALL 

LINK data-set-name LOAD(data-set-name) 
FREE ATTR(attribute-list-name) DD(dd-name) 
ISPEXEC CONTROL DISPLAY REFRESH 
ERROR 


The command procedures running on the TSO host must execute 
these commands exactly as specified in OS/VS2 TSO Command 
Language Reference, GC28-0646. Otherwise, the PCXFBOOT 
command list cannot work. 


If your PCXFBOOT command list cannot work, refer to the 
HELPME.TSO file on the TSO data transfer diskette. The 
HELPME.TSO file gives suggestions for modifying the 
PCXFBOOT.CLIST data set for your host. 


You must also be able to allocate data sets on a default volume 
under your TSO user ID. Otherwise, the UPLOAD program cannot 
work. 


The UPLOAD program creates data sets that start with your defined 
user prefix. If you want to create the data sets with a different start- 
ing qualifier, issue the TSO PROFILE command to change your 

user prefix. 
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TSO Upload Procedure 


If your TSO host will execute all the commands issued by the 
UPLOAD program, follow the procedure in Table E-3 to upload the 
file transfer sample application programs. 


Table E-3. TSO Upload Procedure 


In host computer mode, 
make sure: 


1. You log onto TSO. 


2. The TSO terminal 
monitor program con- 
trols the display. 


If you have already done this, 
skip this step. 


Check to see whether the 
programs are already 
uploaded. Enter EX PCXFER 
(Skip this step if you have 
already checked.) 


If you receive an error 
message, the host is not 
customized. Continue 
with this procedure. 


If you are not in personal 
computer mode, switch 
over to it. 


For backup, make a 
DISKCOPY of the data 
transfer diskette. (Skip 
this step if you have 
already made backup 
copies.) 
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Table E-3. TSO Upload Procedure 
(continued ) 


eee oe 


TSO diskette. (Make sure 
the diskette does not have a 

The customization process 
begins. If you do not 


write-protect tab on it, 
since a checkpoint file is 

receive any status messages 
within 15 minutes, refer to 


written to the diskette.) 

the HELPME file on the 
supplied diskettes. Allow 
at least 1-1/2 hours for this 
uploading process. 


Type UPLOAD TSO 
Press ENTER 


If you want to stop the 

UPLOAD program once 

files start to be sent to the 

host, press the ATTN key 

repeatedly. 
If you have problems 

uploading, refer to the 

with this book. 


HELPME.TSO file 
supplied on the diskette 


Customization completion 
message. 


Note: The upload procedure cannot execute under ISPF Option 6 
or under the control of the Session Manager Program Product. 
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Upload Error Messages for TSO 


A 2% % appears in the operator information area if your 3274 
Control Unit is not customized. 


A 69 in the operator information area means that your dis- 
play station is attached to a 3276 Control Unit, which does not 
support data transfer. 


If nothing happens, and | 4 or | © is displayed in the left of the 
operator information area, your display station is attached to an 
integrated display adapter (IDA). The IDA does not support data 
transfer functions for the IBM 3270 Personal Computer Attach- 
ment. See your supervisor or system programmer. 


Restart the customization process if your host session is inter- 
rupted. The customization resumes as close as possible to the 
point of interruption. . 


If you receive error messages or your customization is not com- 
pleted successfully, see the HELPME file on the diskettes sup- 
plied with this book. You might want a hard copy if you have 
access to a printer. If not, enter TYPE HELPME.TSO. Then, 
press the DUP key to stop the file from scrolling. 
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Appendix F. Data Transfer Formats and 
Translation Tables 


This appendix explains the data formats and translations of the sup- 
plied data transfer sample application programs. It is divided into 
three sections: 


e Screen Capture Formats and Tables 


You use this section for the /E, /N, and /U options of HOST.EXE. 
and for the target-filespec = disk and target filespec = printer. 


e File Transfer Tables 


This section contains ASCII-to-EBCDIC and EBCDIC-to-ASCII 
translation tables for the TRAN option on the PCXFER com- 
mand and the PROFILE entry and for the LIST file format. 


@ Personal Computer File Formats 
This section contains technical descriptions of EDIT, UNFM, 
VAR, BAS, and LIST file formats for the personal computer and 


ASCII-to-EBCDIC and EBCDIC-to-ASCII translation tables for 
the LIST file format. 
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Screen Capture Formats and Tables 


When you capture a screen, you capture the screen in the form of 
records and data printer codes. To write a program to process screen 
images (UNFM or EDIT), you use these formats: 


e Screen Capture Output — Unformatted 


The records in the destination file for unformatted screen-capture 
output (/U option) have the format described in Table F-1. The 
characters will be in 3278/3279 buffer encodings. (Refer to 
Table F-5.) 


Table F-1. Format of Unformatted Screen 
Capture Output 


Number of bytes following the length field 


Buffer type: 00 = character buffer 
Ol = extended attribute 
buffer (EAB) 


Row length: Length of each row of the 
display may be 40, 80, or 132 


Buffer contents: See Table F-1 for char- 
acter buffer values, Table F-4 for attribute 
bytes, and Table F-5 for EAB values. 


e Screen Capture Output — Edit Format (to Printer or Diskette) 


The records in the destination file for formatted screen-capture 
output (without /U) have the formats described in Tables F-2 
through F-4. The first record (Table F-2) is the header unless you 
specify /N. The last record (Table F-4) is the trailer unless you 
specify /N. The characters will be in IBM Personal Computer 
ASCII codes. 
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Note: Hexadecimal values are indicated by X; for example, hexadec- 
imal ODOA is X‘ODOA’. 


Table F-2. Format of Edit Record 1 


Length Contents 


Hyphens 

Space 

Start of Screen Image Captured 
(message) 

Space 

mm/dd/yy 
(mm=month; dd=day of month; 
yy=year) 

Space 

hh:mm:ss 
(hh=hour; mm=minute of hour; 
ss=second of minute) 

Space 

Hyphens 

X‘ODOA’ (ASCII carriage 

return/line feed) 
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Table F-3. Format of Edit Records 
2ton+l 


0 y 
y 2 


Table F-4. Format of Edit Records 


ASCII values corresponding to the char- 
acters visible on the display screen. Null 
and/or space characters at the end of each 
row are suppressed. 

For the ASCII values used, see Table F-6 
if the destination file is a printer, and 
Table F-7 if the destination is a diskette 
file. 

X‘ODOA’ (ASCII carriage return/line feed) 


nt+2 
Length 
0 29 Hyphens 
29 1 Space 
30 19 End of Screen Image (message) 
49 1 Space 
50 28 Hyphens 
78 2 X‘ODOA’ (ASCII carriage 


return/line feed) 
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Tables F-5 through F-7 show the hexadecimal values of the buffer 
contents of the screen you capture. 


e Table F-5 gives the unformatted codes (with /U option and 
target-filespec=personal computer filespec), which you can cap- 
ture only on disk. 


@ Table F-6 gives the ASCII codes of edit output format (without 
/U and target-filespec=LPT1) that you capture to a printer. 


e Table F-7 gives the ASCII codes of edit output format (without 
/U and target-filespec=filename) that you capture to a disk. 
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Table F-5. Screen Capture Unformatted 
odes 


Ox|1x|2x]| 3x] 4x[5x]6x|7x 
xO|vur|sp | 0 | & |a | [A] A 
xem |=/|1|~- [2 |¢é | B/E 
x2ter {> |2]. (ili {ili 


Sd 
—" 


a 
nN 


KK 1 LR LK LK LD lp lo le ld LX 
BRE RE SSAaRBARe 
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Screen Capture Unformatted 


Codes (continued) 


Table F-5. 


Note: For 
attribute 
bytes, see 
Table F-8. 
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Table F-6. Screen Capture Edit Format 
(to Printer) Codes 


; Ble elselmelel= S| 
FY 


translated to X‘20’ (SP). 
translated to X‘2D’ (-). 


nslated to X‘20’ (SP). 


odes are 


All ance hes are 
All other screen c 


All nulls a 
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Table F-6. Screen Capture Edit Format 
(to Printer) Codes 
(continued ) 


xO 
x 1 
x2 | 

x3 | 

x4 

x5 

x6, Note: Only 00 to 7F codes 
x7, are sent to the printer. 

x8 

x9 

xA 

XB 


1xD 
xE 
xF 
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Table F-7. Screen Capture Edit Format 
(to Disk) Codes 


0 


soo 


sp | 0- 
Ya 
a 
$- 
& 
et 
ia 
7 
i 
= 


xO |u| 
xt} | 
x2] | 
x3] | 
x4t | 
x5] | 6 
x6] | 
xT | 
x8} | 
xAlw | 
xBl | 
xDL | 
Emme 
ae 


Varn 


All other screen codes are translated to X‘20D’ (-). 
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Table F-7. Screen Capture Edit Format 
(to Disk) Codes (continued ) 


8x| 9x |Ax|/Bx|Cx/Dx|Ex|Fx 
xO|_ | E |a_ 
| 


lel 


Note: For 
attribute 
bytes, see 
Table F-8. 


ac) 
J 
WY 


ee al le ile ate tet ol ce ee Ll 
Pry tt S| | S| OC] CO, WD] Mj BR] WO] r] =| O 


[|e] oe] om] [=| or [ml ae] nfs] | 
REPERUERRR CCL CE 
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Table F-8 shows the attribute bytes of the buffer contents for edit or 
for unformatted output for screen capture. Table F-9 shows the 
extended attribute bytes (EAB) of the buffer contents for screen 
capture when you specify the /E option. 


Table F-8. Screen Capture UNFM and 
EDIT 3278/3279 Field 
Attribute Bytes 


SS, 4 3 2 1 0 


7 6 


Unprotected 
Protected 


Alphanumeric 
Numeric 


= Display/not selector-light-pen-detectable 
= Display/selector-light-pen-detectable 
= Intensified display/selector-light-pen-detectable 
= Nondisplay (All data in this field is captured 
as space characters.) 


= Field has not been modified 
Field has been modified by the operator 
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Table F-9. Screen Capture 3278/3279 
Extended Attribute Bytes 


Highlight Program Symbol Set 


7 6 5 4 3 2 1 0 


es 


MSB 7, 6 Highlighting: 
00 Default 
01 Blink 
10 Reverse video 
11 Underscore 


Color 

000 Default 
001 Blue 

010 Red 

011 Pink 

100 Green 
101 Turquoise 
110 Yellow 
111 White 


LSB 2,1,0 Program Symbol set: 

000 Default 

001 APL/Text 

010 Program Symbol set A 
011 Program Symbol set B 
100 Program Symbol set C 
101 Program Symbol set D 
110 Program Symbol set E 
111 Program Symbol set F 
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File Transfer 


Tables F-11 and F-12 are translation tables for the personal computer 
file formats EDIT, BAS, VAR, and UNFM using the TRAN option for 
the PCXFER command or PROFILE entry. Tables F-13 and F-14 

are translation tables for the personal computer file format LIST using 
the TRAN option. You can use these tables to find out what is being 
translated in the supplied file transfer sample application programs or 
to write your own file transfer programs. 


Files That Modify Translation Tables 


The (fn ft fm) and (dsname) options of TRAN allow you to change 
the way PCXFER translates a file. (fn ft fm) and (dsname) identify a 
file that contains changes to the translation table used during file 
transfer. The file should have .TR commands to specify which char- 
acters in the translation table should be modified. The figure below 
shows the format of a .TR command 


TR ECHAR ACHAR [ECHAR ACHAR] [ECHAR ACHAR] ... 


The purpose of the different options in the .TR command is described 
in Table F-10. 
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Table F-10. .TR Command Options 


= 


ECHAR 


ACHAR 


When you transfer a file from the host to the personal computer, 
PCXFER translates all instances of each EBCDIC character to the 
ASCII character that follows it. When you transfer a file from the 
personal computer to the host, PCXFER translates all instances of 
each ASCII character to the EBCDIC character that precedes it. 


Indicates that one or more changes should 
be made to the translation table. If .TR 
does not appear in the first three characters 
of a record, PCXFER ignores that record. 


Represents an EBCDIC character. You can 
specify this character by using either a 
1-character value: 


or a 2-character hexadecimal value: 


Cl 
6C 
81 


Represents an ASCII character. You can 
specify this character by using either a 
1-character value: 


or a 2-character hexadecimal value: 
41 
25 


61 
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If a character does not appear in a .TR statement, PCXFER trans- 
lates it using the values specified in Tables F-11 through F-14. 


If you specify an EBCDIC or ASCII character more than once, the 
last occurrence of the character (reading from left to right in each 

record and down the file) is used. For example, if PCXFER finds 

the following statement: 


TRSA6A5A7A 


Then, PCXFER translates X‘5 A’ to X‘7A’ when transferring to the 
personal computer, and translates X*6A’ and X‘7A’ to X‘5A’ when 
transferring from the personal computer. 


When you specify the TRAN option of PCXFER or the PROFILE, all 
characters are translated except for control characters. Examples of 
control characters include X‘ODOA’ at the end of EDIT format file 
records and the printer control characters in LIST format files. 


Below are examples of files that modify translation tables: 
1. 
/*WHEN TRANSFERRING TO THE PC, TRANSLATE */ 


/*ALL UPPER CASE CHARACTERS TO LOWER CASE*/ 
/*WHEN TRANSFERRING FROM THE PERSONAL m/f 


/*COMPUTER, TRANSLATE ALL LOWER CASE a 
/*CHARACTERS TO UPPER CASE */ 
-TRAA2ABbBCcDdAEeFEFGGHATIL 
TRI J KKLIMmNnNOOPpQQqkRr 
eTRSsTtUuVVWwWKXYYZZ 
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/*WHEN TRANSFERRING TO THE PERSONAL * / 
/*COMPUTER, TRANSLATE X'FO' THROUGH X'FF!*/ 


/*TO X'20'. ALSO TRANSLATE X'40 to * / 
/*X'20',. WHEN TRANSFERRING FROM THE * / 
/*PERSONAL COMPUTER, TRANSLATE X'20' TO */ 
/*X" 40° */ 


-TR FO 20 Fl 20 F2 20 F3 20 F4 20 F5 20 
-TR F6 20 F7 20 F8 20 FO 20 FA 20 FB 20 
-TR FC 20 FD 20 FE 20 FF 20 40 20 


/*THIS FILE CAUSES THE TRANSLATION TABLE */ 
/*TO TRANSLATE AS THE TRANSLATION TABLE */ 
/*FOR LIST FORMAT FILES *7 
-TR 8B 7B 9B 7D CO C5 DO CC 


/*THIS FILE CAUSES THE TRANSLATION TABLE */ 
/*TO TRANSLATE AS THE TRANSLATION TABLE */ 
/*FOR FORMATS OTHER THAN LIST FORMAT * / 
-TR 8B C5 9B CC CO 7B DO 7D 
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Table F-11. ASCII-to-EBCDIC Translation 
Table (PCX FER FROM 
TRAN) 


x0} 00 | 10[ 40 | Fo|7C|D7|79 [97 
x1} 01/11 [5A] F1 [cr] Ds [81 | 98 
‘02 [12 | 7F|F2|c2|D9| 82 [99 
-03 [13/78 F3]c3]E2| 83 [a2 
| F4|C4|E3 [84 [a3 

(C5) E4/ 85 [Aa 
C6] Es [86] as 
‘c1| Es [87 [a6 
cs] E7 [88 [A7 
oles |e [Ag 
il [a 

Eo [93 |4F 


Kx 1K 


~S, 
ve 


ald tad aie Cl Call tell tel te Ll Ce Le 
TH PSO] | | 0] 80/| NID] | Bw] 
NIN IAT Rl nin 

a a a Ale(s/s\alsialalel 
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Table (PCXFER FROM TRAN) 


Table F-11. ASCII-to-EBCDIC Translation 
(continued ) 


i Olalalazlelalolalale 
ARRARRERERBEE 


4/8) S| |s|5|8/9/8/8)5/5/4) 
2) 2) 2|$|2/2/8/a/8)2/8/8/8) 5 


ABBE 
© 

© 
F)®/8/S/6/8 2) 8)|/8/5/8/8)8)8 
als 
wW) 
<= 


a 


oe ea ee on seo oe a i oe a 
Nom mon mE onm<c \O tC | tr) m™)| m/e] Ee 
ee ee eee ee le ea 

a Mi Nn 


S = BiS iA 
Se OE 
Mell el oe el el et we we ene et ee 


Data Transfer Formats and Translation F-19 


EBCDIC-to-ASCII Translation 
Table (PCXFER TO TRAN) 
x0| 00| 10| 80] 90| 20/ 26 [2p [Ba 
eT} OL {111811 91 Ad} AS} 2F BB 


Table F-12. 


Ba RI6LO1C/S/S/RIS/R/8/8 

FIN 

sais eelala cilsilse 
NEN 

</2|2| 2] 2) 2) 2] 2/4/a/ 8/8] 8/2 

[2| 8% | 8/8] 3/83) S| 8|=|2/8| < 

Sa SSIS elatsleeieisis 


9/8 


oS 
a 


'2[ 16[AIlAA 


ON 


oe 
ra 


fal 


me | 
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S 

o= 
ri 
MN 

a 
Se 
ae 
mb 
O we 
a 
Cy 
Ow 
7 
ey-* 
po 
a 
fa) 
a8 


a=) 
iB) 
= 
= 
‘3 
= 
S 
OQ 
~~’ 


ce 
a 
AE 
EEE 
a 
2 
ABI: 
& 


Table F-12. 


SPECOCEEEBBEE 
J BRRE RR BRRAROAE 
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Table F-13. ASCII-to-EBCDIC Translation 


Table for LIST (PCXFER 


FROM TRAN LIST) 


Ox fx 2x 1xtdx] 9x Ox17x 


5 s[ele/o[s[e s|olalslalals|s 


Az(e[e\alz\eleleleln <|elsielels 


sta lalatels|alalal=lelalelelalale 
DISA MIP MOIR OIA ||MO] O lm | 
SSIS SRS RIRT RR SRR 


ale|a/&/@/8/8/8)8/2/8/2/9/8|e/8/5 
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Table for LIST (PCXFER 
FROM TRAN LIST) (continued) 


Table F-13. ASCII-to-EBCDIC Translation 


BRAG AR Else eel ede 
B) 8/2) 5/8/2/S/2]B/S/8/9/8/8/5 
Ci i| SO MO] |} | & —=1N| ao 

Als|2/3/2/2/$|2|2| 2) 4/8/28 2 


[BDA re 


[~ 
5 
Fee ee eee 


SEEREOPEEEEEPEEE 
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Table for LIST (PCXFER 


Table F-14. EBCDIC-to-ASCII Translation 
TO TRAN LIST) 


S S S = = BS S = S 
PEREEREREPREE Elelle 
1 re] rr] mM] PM] PS] mS] PT I PM OS] KI OM Om OM OM 
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ica scx ec 0 


glsialelalalslalale [els 
eg) 
3/3 ¢/¢/5/2/2/8/2/5/2/2/8 


8) 8/8/4/8/ 8) 8) 8) 8//8/o 
Sesto seetrate 


tC | 0O 

{Dclaisisielsisis|es|e s[o/ole 
WW) | \O . 

“Siisasaseeigseiees 


Table for LIST (PCXFER TO 


TRAN LIST) (continued ) 


61 


Table F-14. EBCDIC-to-ASCII Translation 
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Personal Computer File Formats 
The personal computer file formats determine what a personal com- 
puter file will look like when it is sent to the personal computer. 
The personal computer file formats are what you look for when you 
receive the file from the personal computer. You use the personal 
computer file formats as part of the PCXFER command options or 
the PROFILE entry. 

EDIT File Formats 
This format is called EDIT format because it is the format used by 
the IBM Personal Computer DOS Editor “EDLIN.” The maximum 
record length is 65535 bytes. 


The EDIT files have the following format: 


Variable-Length Records 
The end of an EDIT file is marked in one of three ways: 


1. A value X‘1A’ after a variable-length record can mark the end 
of the file (the recommended way) 


2. An X‘00’ can be used 


3. Ifthere is no data after the last variable-length record, the end 
of file is at the end of that record. 


Each variable-length record is in the following format: 


Contents of the Record X‘ODOA’ 


X‘ODOA’ is an ASCII carriage return/line feed. 
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UNFM File Formats 


UNF®M files are treated as one continuous string of bytes without any 
record organization. The size of a file is used to find where the string 
ends. 


The UNFM files have the following format: 


Unformatted File 


When a file of this type is transferred to a CMS file or to a TSO data 
set, it is broken into records based on the size of the records of the 
CMS file or TSO data set. For example, if you transferred a UNFM 
file to a CMS file or to a TSO data set with 80-byte variable-length 
records, every 80 bytes of the UNFM file would be treated as a record. 


The unformatted file has the following format: 


80-byte record 80-byte record 
80-byte record 


If this file were then transferred back to the personal computer as a 
UNFM file, the new personal computer file would be identical with 
the original UNFM file. 
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VAR File Formats 


In VAR file formats, the records are of variable length. Each record 
has a 2-byte field, followed by the contents of the record. This is 
similar to OS variable-length records, except that the 2-byte length 
at the beginning of a personal computer variable-length record is 
stored with its least significant byte first. (All 2-byte values are 
stored this way on the IBM Personal Computer.) The value in the 
2-byte field is the length of the contents. of the record only. The 
value does not include the two bytes of length information. The 
maximum size of the contents of a record is 65535. 


The VAR files have the following format: 


| | Variable-Length Records 


Each variable-length record is in the following format: 


Two-Byte 
Length 


Contents of the record | 


The size of the file is used to tell where the file ends. 
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BAS File Formats 


The format of a BAS file is determined by the first byte of the file. 
Depending on this first byte, the file will be in either UNFM or 
EDIT format. 


The UNFM BAS file has the following formats: 


If the first byte of the file is X‘FF’ or X‘FE’, the personal computer 
file format is UNFM. We check for these values because they are 
the values that BASIC uses to identify internal format and protected 
format BAS files on the IBM Personal Computer. 


The EDIT BAS file has the following format: 


If the first byte of the file is not X‘FF’ or X‘FE, the personal com- 
puter file is in EDIT format. You can generate these files from 
BASIC by saving your BASIC program with the ASCII option. 
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LIST File Formats 
LIST file formats are files that are formatted for a printer. If the 
LIST file is being transferred from the personal computer to the host, 
it should be formatted for the IBM Personal Computer Printer. If 
the LIST file is being transferred from the host to the personal com- 
puter, it should be formatted for a host printer. 
Note: LIST file formats should be used only for transferring a file 
that will be printed on a printer. If a LIST file is transferred to one 
computer and then transferred back to the original computer, it will 
not compare byte for byte, but it still will print correctly. 


LIST files on the personal computer must be in EDIT format. (See 
“Edit File Formats.”) These EDIT files may have special characters 
to control the printer. These characters are: 

X‘OC’ — Form Feed 

X‘09’ — Tab 

X08’ — Backspace 

X‘OD’ — Carriage Return 


X‘ODOA’ — Carriage Return Line Feed 
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LIST files on the host contain a 1-byte carriage-control character at 
the beginning of each record. The carriage-control characters that 
the PCXFER program supports are: 


Action Action 
before | without 
Printing Printing | Action Taken 


Print only 

(no space) 
Space one line 
Space two lines 
Space three lines 
Skip to channel 1 

(form feed) 
Null 


The characters in the “Action before Printing’? column cause the 
specified action to take place before printing the record in which 

the carriage-control character was found. The characters in the 
“Action after Printing’? column cause the action to take place 

after the record containing the carriage-control character is printed. 
The characters in the “Action without Printing’ column cause the 
action to take place without printing the record in which the carriage- 
control character was found. 
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As LIST files are transferred from the personal computer: 


1. Tab characters X‘09’ are expanded to the next 8-byte 
boundary. For example, the line 


X‘01 02 03 09 OB 07 01 02 09 03’ 
would become 

9 bytes 17 bytes 
X‘01 02 03 20 20 20 20 20 OB 07 01 02 20 20 20 20 03’ 

2. The IBM Personal Computer Printer control characters X‘OC’ 
(Form Feed), X‘OD’ (Carriage Return), and X‘ODOA’ (Carriage 
Return Line Feed) are replaced by host printer control characters 
which will perform the same functions. 


3. All backspace characters, X‘08’, are deleted. 


Table F-13 is the translation table used for ASCII-to-EBCDIC 
translation for LIST files when TRAN is specified. 


As LIST files are transferred to the personal computer: 


1. The first character of each record is interpreted as follows: 


Action Action Action 
before after without 
Printing Printing | Printing | Action Taken 


Print only (no space) 

Space one line 

Space two lines 

Space three lines 

Skip to channel 1 
(form feed) 

Null 
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The characters in the “‘Action before Printing’? column cause 
the specified action to take place before printing the record in 
which the carriage-control character was found. The characters 
in the “‘Action after Printing’ column cause the action to take 
place after the record containing the carriage-control character 
is printed. The characters in the “Action without Printing”’ col- 
umn cause the action to take place without printing the record 
in which the carriage-control character was found. 


2. When all records have been transferred to the personal computer, 
an end-of-file X‘ODOA1A” is transferred to indicate the end of 
the file. 


Table F-14 is the translation table used for EBCDIC-to-ASCII trans- 
lation for LIST file formats when TRAN is specified. 
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Appendix G. File Transfer Data Streams and 
Error Messages 


File Transfer 


The file transfer function moves data between the host and the per- 
sonal computer, using structured-field format. All requests from the 
user for file transfers are directed to the host. The host communi- 
cates with the personal computer to effect the transfer in the proper 
direction. The maximum number of bytes that can be sent in one 
transmission in either direction is 2K bytes (K equals 1024). 


The 3270 outbound data stream containing structured fields begins 
with a Write Structured Field (WSF) command hexadecimal F3 or 11. 
Multiple structured fields can be sent with one WSF command. 


WSF Structured | Structured Structured 
Field 1 Field 2 Field n 


The 3270 inbound data stream containing structured fields begins 
with an attention identifier (AID): 


Structured Field 


The structures used by the IBM 3270 Personal Computer Attachment 
follow the 3270 data stream format. (For more information on struc- 
tured fields, refer to the JBM 3274 Control Unit Description and Pro- 
grammer’s Guide, GA23-0061.) 


The structures used for file transfer have a common format: 


Structured Field 


Length | Type Parameters and Data 
(2 bytes) (1 byte) 
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The structures used for file transfer defined in this appendix must be 
coded as shown. All constant values are given in hexadecimal. Vari- 
ables are explained following each data string. 


Prior to a request from the host application to the personal computer, 
the host application must verify (with the 3274 Control Unit) that the 
personal computer interface is operational. This is done with a read 
partition query structured field. It requires a specific query reply to 
be returned. 


The QUERY and QUERY REPLY structures verify that a path exists 
between the host application and the personal computer application. 
The host application inquires about the personal computer application. 


If the personal computer application enables the path to the IBM 
3274 Control Unit (for example, using HOST.EXE), the IBM 3274 
Control Unit responds to a QUERY with a QUERY REPLY. This 
QUERY REPLY contains the IBM 3270 Personal Computer Attach- 
ment code and the replies of any other attached features. If the path 
is not enabled, the IBM 3274 Control Unit responds to a QUERY 
with a QUERY REPLY that contains any other attached features. 


When the IBM Personal Computer powers off, the interface to the 
IBM 3274 Control Unit is disabled. If a host application attempts to 
exchange data with a personal computer application, the IBM 3274 
Control Unit returns a Data Stream Error — OP CHECK. (Refer to 
the IBM 3274 Control Unit Description and Programmer's Guide, 
GA23-0061, for more information about OP CHECK.) 


The format of the Query and Query Reply structured fields follows: 


e OUTBOUND = Read Partition Query 
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e INBOUND = Query Reply 


LL 0006 
3 3270 Personal Computer 
Attachment unique 


Message Limit = The 2K length restriction enforced by the IBM 
3274 Control Unit on structures to and from the IBM 3270 Personal 
Computer Attachment, across the feature bus. 


(Refer to the JBM 3274 Control Unit Description and Programmer’s 
Guide, GA23-0061, for more information.) 


Data Compression 
Data compression takes place when there are more than three sequen- 
tial repetitions of the same data code. A 1-byte compression header 
precedes the data. 


Compression Header 


The compression header has the following format: 


7—MSB | O—nocompression 
1 — repeated codes compressed 


ea The length of the data bytes minus 1. 
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If a data code is sequentially repeated three or more times, the 
repeated codes are replaced with a compression header and 

the character to be repeated. For example, if the data to be 

sent were ABCDEEEEEEFGGGGGGGG, the data string would be: 


0 0000100] A] B| C}] C]| D]| 1 0000101 | E| 0 0000000] F | 1 0000111|G 


Compression Header 


File Transfer from Host to Personal Computer 


Requests and responses in the following sequences are used to transfer 
files from the host to the personal computer. 


The following structures detail the message data sent and received by 
the personal computer application through the personal computer 
application program interface (API). 


The DATA part of the insert and get character strings are defined by 
the host file transfer application file formats for the personal com- 
puter. All numbers given in the request and reply function are hexa- 
decimal values. 


Create 


This function initializes a transfer in the personal computer from the 
host. 
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Host Structure (Request) 


LL DO 05 XX O01 04 20 81 08 LO 27 O04 DBS 28 Ll NAME 
11 09 O1 O7 30 FILSIZ 03 L2 FILSPEC 


LL = a 2-byte length field (the length of the structure, includ- 
ing LL). 

XX = 11. 

LO = a 1-byte length field (8 + the length of the format 
NAME). 

DBS = a 2-byte field containing the data block size. 

L1 = a 1-byte length field containing (2 + the length of the 
format NAME). 


NAME = a variable-length field containing the format NAME (in 
ASCII). Refer to “Personal Computer File Formats” in 


Appendix F. 
FILSIZ = a4-byte field containing the file size in data blocks. 
L2 = a 1-byte field containing (2 + the length of the personal 


computer file specification). 
FILSPEC = a variable-length field containing the personal computer 
file specification (in ASCII). 


Personal Computer Structure for an Unsuccessful Transmission 
(Reply) 


O009 DO 0508 69 04 xx xx 


12 00 
1A 00 
1C 00 
2A 00 
45 00 
4A 00 
52 00 
5D 00 
62 00 
63 00 
65 00 
71 00 


Duplicate file name 

File name invalid 

File size invalid 

Path not found 

Record format not allowed 
Record length invalid 
Space not available 
Unsupported type 
Parameter missing 
Parameter not supported 
Parameter value not supported 
Invalid flag value 
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Open 


This function forms a logical connection between an application 

on the host system and a file on the personal computer system. Once 
the connection has been made, requests and data may flow from the 
host to the personal computer. 


Host Structure (Request) 


LL DO OO 12 
O01 00 50 05 


LL 

FX 

Lo 

Ll 
NAME 
L2 


FILSPEC 


O01 06 O01 O1 04 03 OA OO OO OO OO 11 O1 
52 03 FX 08 LO 28 Ll NAME 03 L2 FILSPEC 


a 2-byte length field (the length of the structure, includ- 
ing LL). 

FO — No compression 

F1 — Compression 

a 1-byte length field (8 + the length of the format 
NAME). 

a 1-byte length field containing (2 + the length of the 
format NAME). 

a variable-length field containing the format NAME (in 
ASCII). 

a 1-byte length field (2 + the length of the personal com- 
puter file specification) (in ASCII). 

a variable-length field containing the personal computer 
file specification. 


Personal Computer Structure for a Successful Transmission 


(Reply) 


0005 DO 00 O09 
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Personal Computer Structure for an Unsuccessful Transmission 
(Reply) 


0009 DO OO O08 69 04 xx xx 


01 00 


Open failed exception 


02 00 Arrival sequence not allowed 
1A 00 — File name invalid 

1B 00 File not found 

1C 00 File size invalid 

20 00 Function/open error 

2A 00 — Path not found 

5D00 — Unsupported type 


60 00 
62 00 
63 00 


Command syntax error 
Parameter missing 
Parameter not supported 


65 00 — Parameter value not supported 
7100 — Invalid format 


Insert 
This function writes the next record into the personal computer file. 


Host Structure (Request) 


OOOA DO 47 11 01 05 OO 80 OO LL DO 47 
04 CO NN 61 LD DATA 


LL = a 2-byte length field (the length of the structure from 
LL to the end of DATA). 
NN = hexadecimal 


AO — data compressed 
80 — data not compressed 

LD a 2-byte length field (5 + the length of the data). 

DATA = data beingsent. (See “Personal Computer File Formats,”’ 
in Appendix F.) 


Personal Computer Structure for a Successful Transmission 
(Reply) 


OOOB DO 47 05 63 O06 DATBLK 


DATBLK = a 4-byte field containing the data block number received. 
(For the first data block, DATBLK = 00 00 00 01.) 
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Personal Computer Structure for an Unsuccessful Transmission 
(Reply) 


0009 DO 47 O08 69 O04 xx xx 


0200 — Arrival sequence not allowed 
3E00 — Operation not authorized 
4700 — Record not added, storage limit 
5D 00 — Unsupported type 

6000 — Command syntax error 

6200 — Parameter missing 

63 00 — Parameter not supported 

65 00 — Parameter value not supported 
6E00 — Data element missing 

7000 — Record length =0 

7100 — Invalid flag value 


Close 


This function performs the logical termination of a connection 
between a file on the host system and a previously opened file on the 
personal computer system. 


Host Structure (Request) 


0005 DO 41 12 


Personal Computer Structure for a Successful Transmission 
(Reply) 


0005 DO 41 O09 


Personal Computer Structure for an Unsuccessful Transmission 
(Reply) 


0009 DO 41 08 69 O04 xx xx 


03 00 — Close of an unopened file 
4700 — Record not added to file 
5D 0Q — Unsupported type 

60 00 — Command syntax error 
63 00 — Parameter not supported 
7100 — Invalid format 


G-8 File Transfer Data Streams and Error Messages 


File Transfer from Personal Computer to Host 


Requests and responses in the following sequences are used to transfer 
files from the personal computer to the host. 


Listfile 


Listfile asks for the characteristics of the file at the personal computer 
to be sent to the host. 


Host Structure (Request) 


LL DO 11 11 O01 04 40 11 03 L2 FILSPEC 


LL = a 2-byte length field (the length of the structure, includ- 
ing LL). 
L2 = a 1-byte length field (2 + the length of the personal com- 


puter file specification). 
FILSPEC = a variable-length field containing the personal computer 
file specification (in ASCII). 


Personal Computer Structure for a Successful Transmission 
(Reply) 


LL DO 11 05 11 07 20 FILSIZ 27 04 DBS 28 Ll NAME 


LL = a 2-byte length field (the length of the structure, 
including LL). 

FILSIZ = a4-byte field containing the file size in data blocks. For 
a nondiskette file, this field contains FFFF FFFF. 


DBS = a 2-byte field containing the data block size. 

Ll = a 1-byte field (2 + the length of the format NAME). 

NAME = a variable-length field containing the format NAME 
(in ASCII). 
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Personal Computer Structure for an Unsuccessful Transmission 
(Reply) 


0009 DO 11 08 69 O04 xx xx 


1A 00 — File name invalid 

1B00 — File not found 

2A 00 — Path not found 

5D00 — Unsupported type 

6000 — Command syntax error 

62 00 — Parameter missing 

63 00 — Parameter not supported 
6500 — Parameter value not supported 
7100 — Invalid flag value 


Open | 


This function forms a logical connection between an application on 
the host system and a file on the personal computer system. Once 
the connection has been established, requests may flow from the host 
to the personal computer and data may flow back from the personal 
computer to the host. 


Host Structure (Request) 


LL DO 00 12 O01 06 O1 O01 04 03 OA OO O1 OO OO OO OO Ol 
00 50 05 52 03 FX 08 LO 28 Ll NAME 03 L2 FILSPEC 


LL = a2-byte field (the length of the structure, including LL). 

LO = 4+ the length of the format name. 

Ll = a 1-byte length field containing (2 + the length of the 
format NAME). | 

NAME = a variable-length field containing the format name (in 
ASCII). 

L2 = a 1-byte field (2 + the length of the personal computer 


file specification). 
a variable-length field containing the personal computer 
file specification (in ASCII). 


FILSPEC 


Personal Computer Structure for a Successful Transmission 
(Reply) 


0005 DO O00 09 
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Personal Computer Structure for an Unsuccessful Transmission 


(Reply) 


0009 DO 00 08 69 04 xx xx 


0100 — 
0200 — 
1A 00 — 
1B00 — 
1C 00 — 
2000 — 
2A 00 — 
5D00 — 
6000 — 
6200 — 
63 00 — 
6500 — 
7100 — 


Set Cursor and Get 


Open failed exception 
Arrival sequence not allowed 
File name invalid 

File not found 

File size invalid 
Function/open error 

Path not found 
Unsupported type 
Command syntax error 
Parameter missing 

Parameter not supported 
Parameter value not supported 
Invalid format 


This function sets the logical block pointer (cursor) to the next block 
and retrieves a record from the personal computer file. 


Host Structure (Request) 


00 OF DO 45 11 O01 05 00 06 00 O09 O05 Ol O03 O00 


00 09 DO 46 11 O01 04 00 80 


Personal Computer Structure of Set for an Unsuccessful 


Transmission (Reply) 


00 09 DO 45 08 69 04 xx xx 


02 00 
5D 00 
60 00 
62 00 
63 00 
65 00 
71 00 
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— Arrival sequence not allowed 
— Unsupported type 

— Command syntax error 

— Parameter missing 

— Parameter not supported 

— Parameter value not supported 
— Invalid flag value 
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Personal Computer Structure for a Successful Transmission 
(Reply) 


LL DO 46 05 63 O06 DATBLK CO NN 61 LD DATA 


LL = a2-byte field (the length of the structure, including 
LL). 

DATBLK = a 4-byte field, the data block number being sent. 

NN = hexadecimal 


AO — data compressed 

80 — data not compressed 
LD = a 2-byte length field (5 + the length of the data). 
DATA = the data being sent. 


Personal Computer Structure of Get for an Unsuccessful 
Transmission (Reply) 


0009 DO 46 O08 69 O04 xx xx 


0200 — Arrival sequence not allowed 
22 00 — Get past end of file 

3E00 — Operation not authorized 

5D 00 — Unsupported type 

6000 — Command syntax error 

62 00 — Parameter missing 

63 00 — Parameter not supported 

65 00 — Parameter value not supported 
7100 — Invalid format 


Close 
This function terminates a connection between a file on the host 
system and a previously opened file on the personal computer 
system. 


Host Structure (Request) 


0005 DO 41 12 
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Personal Computer Structure for a Successful Transmission 
(Reply) 


0005 DO 41 09 


Personal Computer Structure for an Unsuccessful Transmission 
(Reply) 


0009 DO 41 08 69 04 xx xx 


03 00 Close of an unopened file 
5D 00 — Unsupported type 

60 00 — Command syntax error 
7100 — Invalid flag value 


Delete 


This function is used to abort a file transfer and to delete the tempo- 
rary personal computer file created by an OPEN prior to CLOSE. 


Host Structure (Request) 


LL DO OB 12 03 L2 FILSPEC 


LL = a 2-byte field (the length of the structure, including LL). 

L2 = a l1-byte field (2 + the length of the personal computer 
file specification). 

FILSPEC = a variable-length field containing the personal computer 
file specification (in ASCII). 


Personal Computer Structure for a Successful Transmission 
(Reply) 


0005 DO OB 09 
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Personal Computer Structure for an Unsuccessful Transmission 
(Reply) 


0009 DO OB 08 69 04 xx xx 


0200 — Arrival sequence not allowed 
1A 00 — File name invalid 

2A 00 — Path not found 

5D 00 — Unsupported type 

6000 — Command syntax error 
6200 — Parameter missing 

63 00 — Parameter not supplied 
7100 W— Invalid flag value 
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Sample File Transfer Program Error Messages 
Usually, the only messages you see from the file transfer sample 
application programs are self-explanatory. There are some “impos- 
sible to occur’? messages with error codes only. These “‘impossible”’ 
messages can occur if you modify and test the sample programs 
or if you encounter a bug in the sample program. 

The error messages in this section can give you a direction in which 

to search for a solution to the error, but do not give you the solution. 
Refer to the publications below if you need more information about 
an error message. You will also find the earlier sections of this appen- 
dix about the data stream helpful. 


e JBM Virtual Machine/System Product: System Programmer's 
Guide, SC19-6203 


e IBM Virtual Machine/System Product: CMS Command and 
Macro Reference, SC19-6209 


e IBM 3270 Information Display System: 3274 Control Unit 
Description and Programmer’s Guide, GA23-0061 


@ OS/VS2 MVS Data Management Macro Instructions, 
GA26-3873 


e OS/VS2 Guide to Writing a Terminal Monitor Program or a 
Command Processor, GC28-0648 


@ OS/VS2 MVX Supervisor Services and Macro Instructions, 
GC28-0683. 


These “impossible” messages are listed by category: 
e@ Personal computer program error 

e Unexpected personal computer response 

e Data stream error 

e CMS macro failure or command failure 


e TSO macro failure 
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Console I/O error 

3274 Control Unit error 

Unexpected storage request error (GETMAIN macro) 
Unexpected storage request error (DMSFREE macro) 


Unexpected attention identifier. 


Personal Computer Program Error 


PC Program Error, Error code = ‘xxx’, Error info = ‘error info’ 


This message provides information for a user writing an application 
program on the IBM Personal Computer that communicates with the 
CMS or TSO file transfer program. Table G-1 describes the program 
error codes. Refer to the data stream sections of this appendix to 
understand the descriptions of the error codes. The DATBLK sec- 
tion is the sequence X*6306’ DATBLK; the DATA section is the 


sequence X‘CO’ NN X‘61’ LD DATA. 
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Table G-1. Personal Computer Program 
Error Codes 


Error Error | Error 
Code Description Information 


The first two bytes of 
the error information 
contain the maximum 
length in bytes allowed 
by the 3274 Control 
Unit. Bytes 3 and 4 
contain the length 
specified by the personal 
computer program. 


The personal computer 
program is planning to 
send blocks that are big- 
ger than the 3274 control 
unit wil support, cur- 
rently 2048 bytes. If the 
personal computer pro- 
gram indicates in the 
DBS field of its response 
to a LISTFILE request 
that it will be sending 
blocks greater than 2032 
bytes (16 bytes of over- 
head are sent with every 
block), this message 
OccuUIS. 


The SET CURSOR AND 
GET reply is missing a 
DATA or DATBLK 
section. 


The personal computer’s 
response to a GET request 
does not contain a DATA 
section. 


The first 55 bytes of the 
personal computer’s reply 
to the GET request. 


The personal computer 
response to a GET request 
does not contain a 

DATBLK section. 


The first 55 bytes of the 
personal computer’s reply 
to the GET request. 
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Table G-1. Personal Computer 
Program Error Codes 
(continued ) 


Error Error Error 
Code Description Information 


49 The compressed data sent | The first 55 bytes of the 
by the personal computer 
after a GET request was 
invalid. The CMS and 
TSO file transfer programs 
verify that the lengths of 
the repeated and non- 

3 repeated data fields in the 
compressed data match the 
length of the data. A length 
of 2 is used for each 
repeated data field, and (2 + 
the length of the non- 
repeated data) is used for 
each nonrepeated data 
field. 


personal computer’s reply 
The personal computer 


to the GET request. 
returned an invalid reply 
to a CREATE request. 


The first 55 bytes of the 
personal computer’s reply 
to the CREATE request. 


The personal computer 
returned an invalid reply 
to the CREATE and 

OPEN requests. 


The first 55 bytes of the 
personal computer’s reply 

to the CREATE and OPEN 
requests. 


The personal computer 
returned an invalid reply 
to the LISTFILE request. 


The first 55 bytes of the 
personal computer’s reply 
to the LISTFILE request. 


The personal computer 
returned an invalid reply 
to an OPEN request. 


The first 55 bytes of the 
personal computer’s reply 
to the OPEN request. 
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Table G-1. Personal Computer 


Program Error Codes 
(continued ) 
Error 


Error Error 
Description Information 


The first 55 bytes of the 
personal computer’s reply 
to the CLOSE request. 


The personal computer 
returned an invalid reply 
to a CLOSE request. 


The first 55 bytes of the 
personal computer’s reply 
to the INSERT request. 


The personal computer 
returned an invalid reply 
to an INSERT request. 


The first 55 bytes of the 
personal computer’s reply 
to the SET request. 


The personal computer 
returned an invalid reply 
to a SET request. 


The personal computer 
returned an invalid reply 
to a GET request. 


The first 55 bytes of the 
personal computer’s reply 
to the GET request. 


The personal computer 
returned an invalid reply 
to a SET CURSOR AND 
GET request. 


The first 55 bytes of the 
personal computer’s reply 

to the SET CURSOR AND 
GET request. 


The DATA section of the 
personal computer’s reply 
to a GET request is invalid. 


The first 55 bytes of the 
personal computer’s reply 
to the GET request. 


The DATBLK section of the 
personal computer’s reply 
to a GET request is invalid. 


The first 55 bytes of the 
personal computer’s reply 
to the GET request. 
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Table G-1. Personal Computer 
Program Error Codes 


(continued ) 
Error Error Error 
Code Description Information 


203 A structured field was read 
from the 3270 Personal 
Computer Attachment at 

a time it was not expected. 
There is an error in the 
personal computer pro- 
gram, or the CMS and 
personal computer pro- 
grams are not synchro- 
nized with each other. If 
the programs are not 
synchronized, the problem 
can be fixed by restarting 
the programs. 
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Unexpected PC Response 
Unexpected PC Response 


A structured field was read from the IBM Personal Computer Attach- 
ment at a time it was not expected. There is an error in the personal 
computer program, or the TSO and personal computer programs are 
not synchronized with each other. If the programs are not synchro- 
nized, the problem can be fixed by restarting both programs. 


Data Stream Error 


Data Stream Error, Error code = ‘xxx’, Request = ‘name’, Major 
RC = ‘xx xx’ 


The CMS, TSO, and personal computer file transfer programs use a 
protocol to communicate as they transfer files. The data stream sec- 
tions in this appendix describe this protocol. This error message 
occurs if the personal computer program responds to a request with 
a major return code that the CMS or TSO program did not expect. 
Below is a list of the specific error codes: 


Data stream error, error code = 63, request = CLOSE, 
major RC = ‘xx xx’ 


Data stream error, error code = 64, request = LISTFILE, 
major RC = ‘xx xx’ 


Data stream error, error code = 65, request = CREATE, 
major RC = ‘xx xx’ 


Data stream error, error code = 66, request = INSERT, 
major RC = ‘xx xx’ 


Data stream error, error code = 67, request = SET, major 
RC = *xx xx’ 


Data stream error, error code = 68, request = GET, major 
RC = *xx xx’ 
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Data stream error, error code = 69, request = CREATE/OPEN, 
major RC = ‘xx xx’ 


Data stream error, error code = 70, request = OPEN, 
major RC = *xx xx’ 


CMS Macro Failure or Command Failure 


CMS Macro Failure Occurred, Error code = ‘xxx’, 
Macro name = ‘name’, Macro RC = ‘RC’, CMS-fileid = ‘name’ 


The CMS file transfer program uses the CMS file access macros des- 
cribed in JBM Virtual Machine/System Product: CMS Command and 
Macro Reference, SC19-6209. If one of these macros returns a code 
that the file transfer program does not expect, this message occurs. 
The specific error codes are: 

140: CMS FSSTATE macro failed on input file 

141: CMS FSOPEN macro failed on input file 

142: CMS FSREAD macro failed on input file 

240: CMS FSWRITE macro failed on output file 

241,258: CMS FSSTATE macro failed on output file 

242: CMS FSOPEN macro failed on output file 

243: CMS FSCLOSE macro failed on output file 

244,245: CMS FSERASE macro failed on output file 


CMS Command Failure occurred, Error code = 259, Command 
name = LISTFILE, Command RC = 


The CMS command LISTFILE failed. The return codes is ‘RC’. Refer 


to the JBM Virtual Machine/System Product: CMS Command and 
Macro Reference, SC19-6209. 
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TSO Macro Failure 


TSO Macro Failure Occurred, Error code = ‘xxx’, Macro name = 
‘name’, Macro RC = ‘RC’ 


The TSO file transfer program uses the TSO macros described in 
OS/VS2 MVS Data Management Macro Instructions, GC26-3873, and 
OS/VS2 Guide to Writing a Terminal Monitor Program or a Command 
Processor, GC28-0648. If one of these macros returns a code that the 
file transfer program does not expect, this message occurs. The spe- 
cific error codes are: 


140: TSO STATE error; could not determine the input data 
set characteristics 


141: TSO OPEN failed on input data set 
142: TSO GET failed on input data set 
143: TSO PUT failed on output data set 
145: TSO OPEN failed on output data set 
146: TSO CLOSE failed 

220: TSO TGET failed 


Console I/O Error 


Console I/O Error Occurred, Error code = ‘xxx’, Error info = 
‘error info’ 


Table G-2 describes the CMS error codes that can occur. The Diag- 
nose commands X ‘24’ and X‘58’ referred to are described in JBM 
Virtual Machine/System Product: CMS Command and Macro 
Reference, SC19-6203. 


File Transfer Data Streams and Error Messages G-23 


Table G-2. Console I/O Error Codes 


Error Error Error 
Code Description Information 


The IBM 3270 Personal 
Computer Attachment is 
not properly connected 
to the user’s virtual 
machine. 


The condition code 
returned by a Diagnose 
X‘24’ instruction, which 
determined that the IBM 
3270 Personal Computer 
Attachment was not 
properly connected. 


A write to the IBM 3270 
Personal Computer 
Attachment did not work 
correctly. Only part of 
the message was written. 


The channel status word 
(CSW) at the time the 
error was detected. 


The CSW at the time the 
error was detected. 


No channel end or device 
end was returned after a 
write to the IBM 3270 
Personal Computer 
Attachment. 


The CSW at the time the 
error was detected. 


Channel errors occurred 
during a write to the IBM 
3270 Personal Computer 
Attachment. 


The CSW at the time the 
error was detected. 


A Diagnose X‘58’ request 
failed, for an unknown 
reason, during a write to 
the IBM 3270 Personal 
Computer Attachment. 
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Table G-2. Console I/O Error Codes 


(continued ) 
Error Error Error 
Code Description Information 
The IBM 3270 Personal The CSW at the time the 


Computer Attachment is error was detected. 
not operational for some 


reason. 


A unit check occurred dur- 
ing a write to the IBM 
3270 Personal Computer 
Attachment. 


The first 8 bytes are the 
CSW at the time that the 
error occurred. The last 
byte is sense information 
indicating what caused the 
unit check. The JBM 
3270 Information Dis- 
play System 3274 Con- 
trol Unit Description 

and Programmer’s Guide, 
GA23-0061, explains the 
sense information. 


The CSW at the time the 
error was detected. 


Channel errors occurred 
during a read from the 
IBM 3270 Personal 
Computer Attachment. 


The CSW at the time the 
error was detected. 


A Diagnose X‘58’ 

request failed, for an 
unknown reason, during 

a read from the IBM 3270 
Personal Computer 
Attachment. 
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Table G-2. Console I/O Error Codes 
(continued) 


Error Error Error 
Code Description Information 


9 a 


get any information back 
from the IBM 3270 
Personal Computer 
Attachment. 


199 A unit check occurred dur- | The first 8 bytes are the 
200 ing a read from the IBM CSW at the time the error 
3270 Personal Computer occurred. The last byte is 


sense information indicat- 
ing what caused the unit 
check. The JBM 3270 
Information Display Sys- 
tem 3274 Control Unit 
Description and Program- 
mer’s Guide, GA23-0061, 
explains the sense 
information. 


Attachment. 


The CSW at the time the 
error was detected. 


Channel errors occurred 
while the console screen 
was being cleared. 


A Diagnose X‘58’ 
request failed, for an 
unknown reason, while 
the console screen was 
being cleared. 


The CSW at the time the 
error was detected. 
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3274 Control Unit Error 


3274 Control Unit Error Occurred, Error code = ‘xxx’, Error info 
= ‘error info’ 


The following error codes can occur: 


171: A Read Partition Query to the 3274 controller did not 
work correctly. The reply was not in the correct format. 


176: The 3274 did not answer a Read Partition Query within a 
certain amount of time. Error information is the number of 
seconds that the program waited for the answer. 


Unexpected Storage Request Error — GETMAIN 


Unexpected Storage Request Error, Error code = 230, 
GETMAIN, RC = ‘RC’ 


The TSO file transfer program uses the GETMAIN macro described 
in the OS/VS2 MVS Supervisor Services and Macro Instructions, 
GC28-0683. If the macro returns with a code that the file transfer 
program does not expect, this message occurs. 


Unexpected Storage Request Error — DMSFREE 


Unexpected Storage Request Error, Error code = 230, 
DMSFREE, RC = ‘RC’ 


The CMS file transfer program uses the DMSFREE macro described in 
the JBM Virtual Machine/System Product: System Programmer’s 


Guide, SC19-6203. If the macro returns with a code that the file 
transfer program does not expect, this message occurs. 


Unexpected Attention Identifier 
Unexpected Attention Identifier, (AID) = ‘AID received’ 


The TSO file transfer program has found an unexpected attention 
identifier, or AID byte, in an incoming message. 
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Appendix H. Advanced Diagnostics 


Introduction 


This appendix is an addendum to the Advanced Diagnostics in the 
IBM Personal Computer Hardware and Service manual. 


The numbered exit points in the following procedures refer to exit 
points from the problem determination procedures in Chapter 6. 
Whenever a problem determination procedure leads to an exit point, 
you may continue detailed problem isolation using the additional pro- 
cedures with the corresponding exit point in this appendix. 


Persons assigned to maintain the IBM Personal Computer 3270 
Attachment Option should understand the wiring diagrams of the dis- 
tribution box and all interconnecting cables. See Figures D-2 through 
D-5, in Appendix D. 


Read Figure D-3 carefully when testing the feature bus cable for con- 
tinuity and shorts. In this figure, the feature bus cable is not wired in 
the conventional manner. The wires do not run to the same con- 
nector pins at bothends of the cable. With this unique wiring method, 
feature bus cable problems can be diagnosed without a multimeter or 
any other test equipment. Since the physical signal path changes 
when the ends are swapped, a faulty cable presents different failure 
symptoms after the cable ends are swapped. 
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Advanced Diagnostics Follow-Up Procedure 
From Problem Determination Procedure 2 
EXIT POINT 225 
A 301 error message that stays on the screen indicates either a 
faulty keyboard cable or a faulty IBM Personal Computer 3270 
Adapter. 
Check that the keyboard pigtail is connected properly. See Figure 64. 
Also check the keyboard signal path from the keyboard DIN con- 
nector through the distribution box to the personal computer card 


connector for continuity and shorts. See Figure D-2. 


If you do not find any trouble, replace the IBM Personal Computer 
3270 Adapter. 


EXIT POINTS 235, 255, 265 
Remove all nonessential adapters and memory modules. Ifthe problem 


persists, perform the diagnostics in the [BM Personal Computer Hard- 
ware and Service manual. 
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From Problem Determination Procedure 3 
EXIT POINT 315 


Test the distribution box from connector B to the 79-pin connector 
for continuity and shorts. If no trouble is found, replace the IBM 
Personal Computer 3270 Adapter. See Figures D-2 through D-5 for 
wiring diagrams of the distribution box and of the keyboard adapter 
cable pigtail. 


EXIT POINT 325 

Repair or replace the feature bus cable. 

EXIT POINT 365 

Test the video cable for continuity and shorts. If no trouble is found, 
replace the monochrome display and parallel printer adapter. If the 
problem persists, have the display serviced. See Figures D-2 through 
D-5 for wiring diagrams. 


EXIT POINT 375 


Test the video cable for continuity and shorts. If no trouble is found, 
replace the color/graphics monitor adapter. If the trouble persists, 
have the display serviced. 
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From Problem Determination Procedure 4 
EXIT POINT 415 


Test the distribution box keyboard connectors A and C to the 79-pin 
connector for continuity and shorts. Also test the keyboard adapter 
cable pigtail for continuity and shorts. If no trouble is found, replace 
the IBM Personal Computer 3270 Adapter. See Figures D-2 through 
D-5 for wiring diagrams of the distribution box and of the keyboard 
adapter cable pigtail. 


EXIT POINT 425 
Repair or replace the keyboard adapter cable. 
EXIT POINT 439 
Test the keyboard adapter cable pigtail to the 79-pin connector for 
continuity and shorts. If no trouble is found, replace the IBM 
Personal Computer 3270 Adapter. See Figures D-2 through D-5 
for wiring diagrams of the distribution box and of the keyboard 
adapter cable pigtail connector. 
EXIT POINTS 437, 435 
Replace the IBM Personal Computer 3270 Adapter. 

From Problem Determination Procedure 5 
EXIT POINT 505 
Replace the IBM Personal Computer 3270 Adapter. 
EXIT POINT 515 
Test the distribution box keyboard connectors A and C to the 79-pin 
connector for continuity and shorts. If no trouble is found, replace 
the IBM Personal Computer 3270 Adapter. See Figures D-2 through 
D-5 for wiring diagrams of the distribution box and of the keyboard 
adapter cable pigtail. 
EXIT POINT 525 
Replace the IBM Personal Computer 3270 Adapter. 
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From Problem Determination Procedure 6 
EXIT POINT 605 
Replace the IBM Personal Computer 3270 Adapter. 
EXIT POINT 615 


Replace the IBM Personal Computer 3270 Adapter. Following are 
the error codes: 


ee [ati 
1950 Keyboard serializer 


1951 Buffer memory 


EXIT POINTS 635, 645 


Repair or replace the feature bus cable. 
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From Problem Determination Procedure 7 
EXIT POINT 715 
Repair or replace the feature bus cable. 
EXIT POINT 725 
Test the feature bus cable for shorts and continuity. 


If no trouble is found, test the distribution box from connector B 
to the 79-pin connector for continuity and shorts. 


If no trouble is found, replace the IBM Personal Computer 3270 
Adapter. See Figures D-2 through D-5 for wiring diagrams of the 
distribution box and of the cables. 


EXIT POINT 735 


Test the feature bus cable and the video cable for continuity and 
shorts. See Figure D-3 for the wiring diagram of the cable and of the 
distribution box. 


If no trouble is found, test the distribution box from connector B to 
the 79-pin connector for continuity and shorts. If no trouble is 
found, replace the IBM Personal Computer 3270 Adapter. 


If, after replacing the IBM Personal Computer 3270 Adapter and 


testing the distribution box, you still have the problem, have the 
system unit serviced. 
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From Problem Determination Procedure 8 | 
EXIT POINT 820 


Following are the operator information area error codes for the 
feature bus: 


235 Invalid status or command queue failure. The feature 
bus adapter has returned invalid status, or a command 
queue to the feature bus adapter has failed after retry. 


Lost OP complete. More than 1 second has elapsed 
since the 3274 initiated an operation to the personal 
computer requiring an OP complete and that status 
was not received (for example, doing a keyboard 


system reset during a file transfer). 


Message protocol error. The 3274 has detected a 
protocol error in communicating with the personal 
computer. 


Inbound message too long. While processing an 
inbound structured field message from the personal 
computer, the 3274 received more than 2048 bytes 
of data before an end-of-message indicator was 
received. 
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From Problem Determination Procedure 9 


EXIT POINT 915 


Test the video cable and the feature bus cable for continuity and 
shorts. See Figures D-3 and D4 for wiring diagrams. Repair or 
replace the faulty cable. 


EXIT POINT 925 


Test the distribution box from connector B to the 79-pin connector 
for continuity and shorts. If no trouble is found, replace the IBM 
Personal Computer 3270 Adapter. See Figures D-3 through D-5 

for wiring diagrams of the distribution box. 


EXIT POINT 975 


Test the video cable for continuity and shorts. If no trouble is 
found, replace the color/graphics monitor adapter. If the trouble 
persists, have the display serviced. See Figures D-2 through D-5 
for wiring diagrams. 
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Appendix I. Parts List 


Following are the part numbers for the IBM 3270 Personal Computer 


Attachment. 
Major 
Unit Part 
Part Code Number 
Feature Bus cable 324 4752127 
Video cable 324 4752128 
Keyboard Adapter cable 324 4752129 
Distribution box 324 4752146 
Card guide 324 1652473 
IBM Personal Computer 3270 Adapter | 
For 3278 Display with System Unit 324 6931963 
Model 5150 or 
4757530 
or 
1899619 
For 3278 Display with System Unit 324 6931963 
Model 5160 
For 3279 Color Display with System 324 8233718 
Unit Model 5150 or 
3 6931963 
For 3279 Color Display with System 324 6931963 
Unit Model 5160 
IBM 3270 Personal Computer 8501207 
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Parts List I-1 


Appendix J. Repack Instructions 


Follow these instructions in sequence when returning the system unit 
for repair. For instructions on relocating the Personal Computer sys- 
tem, refer to Section 6 of the JBM Personal Computer Guide to 
Operations manual. 


Return all IBM cards and cables. DO NOT return other manufacturers’ 
equipment with the system unit. 


Step 1 


1. Lift the lever. 


2. Remove the diskettes from the diskette drive unit. 


If you have an IBM Personal Computer Expansion Unit, go to 
Step 2. If not, go to Step 3. 
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Step 2 


Warning: Normal shipping and handling can cause a permanent 

loss of all data on the fixed disk(s). You should back up all files onto 
diskettes before continuing. Depending on the amount of data stored, 
you might require about 32 diskettes to back up each fixed disk. 
Refer to the JBM Disk Operating System manual for a description of 
the BACKUP command. 


Once you have backed up your fixed disk(s), follow these steps to 
secure them from moving: 


1. Insert your diagnostic diskette. 
2. Set the expansion unit (if attached) On/Off switch to On. 
3. Set the system unit On/Off switch to On. 


4. Remove the system diskette from drive A of the system unit (if 
used). 


5. Insert the IBM Personal Computer Diagnostic diskette into drive 
A of the system unit. 


6. From the keyboard, type A:COMMAND then press ENTER. 
7. The following message appears on your screen: 


SELECT AN OPTION 

0--RUN DIAGNOSTIC ROUTINES 
1—-FORMAT DISKETTE 

2—COPY DISKETTE 

3—PREPARE FIXED DISK FOR RELOCATION 
9--EXIT TO SYSTEM DISKETTE 

ENTER THE ACTION DESIRED 

9 


8. Enter 3. 


The disk head moves over the highest available cylinder, the posi- 
tion used when moving your system. 


9. The following message appears on your screen: 


FIXED DISK(S) READY FOR SHIPPING 
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Step 3 
1. Set the system unit On/Off switch to Off. 
2. Set the display On/Off switch to the Off position (0). 


3. Set the On/Off switches of any other devices attached to the sys- 
tem unit to the Off position. 


4. Remove the system unit power cord from the wall outlet. 


5. Remove the system unit power cord from the system unit. 


Power Cord Socket 


System Unit Power Cord 


Power Outlet 
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Step 4 
1. At the rear of the display, remove the video cable by squeezing 
the spring latches (on the top and bottom) toward each other and 
pulling the cable connector out. 


2. Remove the feature bus cable in the same way. 


3278 Display 


Video Test Switch 


Feature Bus 


Cable 
—G——= Video Cable 
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3279 Color Display 


/ Feature Bus 
Cable 


t] 
Keyboard 
Adapter Cable 


Video Cable 
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Step 5 


1. Unscrew the wing screw by turning it counterclockwise (¥ )). 


Pull the keyboard cable connector out. Reinsert the wing 
screw into the stud. 


2. Remove the feature bus cable by squeezing the spring latches 
toward each other and pulling the cable connector out. 


3. Remove the keyboard adapter cable by squeezing the spring 
latches toward each other and pulling the cable connector out. 


4. Pull the keyboard adapter cable pigtail lead from the keyboard 
socket. . 


5. Unscrew the two screws on the video cable, and pull the video 
cable out. 


Video Cable 


Keyboard Adapt 
Cable Pigtail Sig Shr, 
To Display .<4~#— Keyboard Cable 
a 
g 
Keyboard Adapter 
Cable : Feature Bus To Keyboard 


Cable 
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Step 6 


1. Coil the keyboard adapter cable, the video cable, and the feature 
bus cable, and insert each cable into its plastic shipping bag. (See 
figure below.) Do the same for the power cord. 


2. Remove any other cables from the system unit and keep them. 
3. Remove the distribution box by removing the two screws and 


pulling the distribution box out. Put the distribution box into its 
shipping carton. 
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Step 7 
Note: Use all the packing materials (corner braces, foam cushions, 
etc.), and pack all parts in the original cartons if available; cushion 


well to prevent damage if you use different cartons. 


1. Put the system unit in its shipping bag. 


2.. Set the keyboard adapter cable, the video cable, the feature bus 
cable, and the distribution box in the center well in the bottom 
foam cushion. 
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3. Lower the system unit onto the foam cushion. 


5. Close and tape the shipping carton. 
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Glossary of Terms and Abbreviations 


This glossary includes terms and definitions from the JBM Vocabulary for 
Data Processing, Telecommunications, and Office Systems, GC20-1699., 


A 


ACF/TCAM. Advanced Communication Function for the 
Telecommunications Access Method. 


address bus. A set of wires or signals carrying the binary-coded address 
from the Intel 8088 microprocessor throughout the rest of the IBM 
Personal Computer System Unit. 


addressing. (1) The assignment of addresses to the instructions of a 
program. (2) The means whereby the originator or a control station 
selects the unit to which it is going to send a message. 


Advanced Communication Function for the Telecommunications 
Access Method (ACF/TCAM). A program product that provides single- 
domain network capability and, optionally, multiple-domain capability. 


AEN. Address Enable. 

AID. Attention identifier. 

alphameric. Synonym for alphanumeric. 

alphanumeric. Pertaining to a character set that contains letters, digits, 
and usually other characters, such as punctuation marks. Synonymous 


with alphameric. 


Alt key functions. Keyboard functions printed on the front of the key 
that are selected when the Alternate (Alt) key is pressed with the desired 
key. 


American National Standard Code for Information Interchange (ASCII). 
The standard code used for exchanging information among data processing 
systems and associated equipment. 


American National Standards Institute (ANSI). An organization for the 
purpose of establishing voluntary industry standards. 
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ANSI. American National Standards Institute. 
APAR. Authorized program analysis report. 


application. A program that is written by or for a user and that applies to 
the user’s work, for example a payroll application program. 


ASCII. American National Standard Code for Information Interchange. 


assembler. A computer program used to assemble. Synonymous with 
assembly program. 


assembler language. A source language that includes symbolic machine 
language statements in which there is a one-to-one correspondence with 
the instruction formats and data formats of the computer. 


assembly program. Synonym for assembler. 


Asynchronous Communications Adapter. The adapter that provides a 
channel to data processing or input/output devices outside of your 
immediate system. These can be connected by telephone, with a plug-in 
modem, or directly by cable when the device is nearby. 


attachment option enhancements diskette. The diskette that contains 
supplementary sample application programs, such as the XLATKBD 
program, the BASIC Application Program Interface, and the PASCAL 
Application Program Interface. 


attention identifier (AID). A code in the inbound 3270 data stream that 
identifies the source or type of data that follows. 


attribute byte. In 3270 applications, the byte used for data security to 
indicate whether a certain field can be or has been changed. 


authorized program analysis report (APAR). A report of a problem caused 
by a suspected defect in a current unaltered release of a program. 


B 
back up. To duplicate data from a fixed disk drive or diskette to another 
diskette to ensure availability of the data in the event of loss of or damage 


to the original. Do not confuse this term with the DOS 2.0 fixed disk 
command. (See DOS 2.0 manual). 
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BASIC. Beginner’s all-purpose symbolic instruction code. 


beginner’s all-purpose symbolic instruction code (BASIC). A high-level, 
widely used computer programming language. 


binary. Pertaining to a selection, choice, or condition that has two 
possible values or states. 


binary digit. Synonym for bit. 


binary synchronous communication (BSC). (1) Communication using 
binary synchronous line discipline. (2) A uniform procedure, using a 
standardized set of control characters and control character sequences, 
for synchronous transmission of binary-coded data between stations. 


BIOS. Basic Input/Output System. 


bit. In binary notation, either of the characters 0 and 1. Synonymous 
with binary digit. 


break. A personal computer function that stops whatever action is in 
progress, such as stopping a program in the middle of execution. 


BSC. Binary synchronous communication. 

buffer. (1) An area of storage that is temporarily reserved for use in 
performing an input/output operation, into which data is read or from | 
which data is written. Synonymous with input/output area. (2) A 
portion of storage for temporarily holding input or output data. 


bus. One or more conductors used for transmitting signals or power. 


byte. (1) A binary character operated upon as a unit and usually shorter 
than a computer word. (2) The representation of a character. 


C 


carriage control character. The first character of an output record (line) 
that is to be printed; for example, the carriage control character can 
determine how many lines should be skipped before the next line is 
printed. 


CLK. Clock. 
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CMS. Conversational monitor system. 


Color/Graphics Monitor Adapter. A medium-resolution monitor adapter 
designed to attach a wide variety of TV frequency monitors and TV sets. 


control unit. A device that controls input/output operations at one or 
more devices, such as the 3274 Control Unit, the 3276 Control Unit 
Display Station, or the Integrated Display Adapter (IDA). 


conversational monitor system (CMS). A virtual machine operating system 
that provides general interactive time sharing, problem solving, and 
program development capabilities, and operates only under the control of 
the VM/370 control program. 


cursor. The movable spot of light, on a display screen, that indicates 
where the next character will be entered, replaced, or deleted. 


customization. The procedure performed in personal computer mode that 
prepares your IBM 3270 Personal Computer Attachment DOS diskette 
from the IBM Personal Computer DOS diskette and the Customization 
diskette. 

D 
data. All information entered into or used by a computer. 
data compression. A technique that saves storage space by eliminating 
gaps, empty fields, redundancies, or unnecessary data to shorten the 
length of records or blocks. 
data stream. The commands, control codes, orders, attributes, and data or 
structured fields for 3270 devices transmitted inbound to an application 


program or outbound to a terminal. 


data transfer. The transfer of data between host applications and personal 
computer applications by screen capture or file transfer. 


default. A value that is assumed when none has been specified. 


diagnostic. Pertaining to the detection and isolation of a malfunction or 
mistake. 


DIN connector. One of the connectors specified by the DIN 
standardization committee. 
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disk. The term that refers to both the diskette and the fixed disk in this 
manual. 


disk operating system (DOS). A program that interacts with the system 
processing unit and the disk/diskette drive to control the flow of data. A 
DOS program is the link between you and your system hardware. You 
must be in DOS to perform operations affecting entire diskettes or 
multiple diskettes. 


diskette. A personal computer storage device consisting of a flexible 
magnetic disk inside a protective plastic jacket. 


diskette drive. A device that uses diskettes for mass storage and retrieval 
of data. 


display. An output unit for the visual display of data. 
DOS. Disk operating system. 
dynamicizer. Synonym for serializer. 
E 
EAB. Extended attribute buffer. 
EBCDIC. Extended binary-coded decimal interchange code. 
ECSA. Extended Character Set Adapter. 


edit format. A screen capture output format that copies information 
as it appears on the screen. 


enabled. Pertaining to a state of the processing unit that allows the 
occurrence of certain types of interruptions. Synonymous with 
interruptible. 


extended attribute buffer (EAB). The buffer in which the extended field 
attribute for the 3270 Kenji display field is stored. 


extended binary-coded decimal interchange code (EBCDIC). A coded 
character set consisting of 8-bit coded characters. 
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Extended Character Set Adapter. The storage that provides the additional 
control and buffering necessary for the extended character set in the APL/ 
TEXT feature and for the field and character attributes for extended 
color, programmed symbols, and extended highlighting. 


F 


field. In a record, a specified area used for a particular category of data, 
for example, a group of card columns in which a wage rate is recorded. 


file. A collection of data. This data can be programs, word processing 
files, or computational information. Files are stored either in the host 
computer or on personal computer diskettes. Files are also called data 
sets. 


file transfer. The function that allows you to send and receive files or 
data sets between the personal computer and the host when the file 
transfer code resides in your host. 


fixed disk. One type of personal computer data storage. This storage 
device is housed in the system unit. A fixed disk is composed of rigid 
material with a magnetic coating. It is used for mass storage and retrieval 
of data. 


G 


gate. (1) Acombinational circuit with only one output channel. (2) A 
device having one output channel and one or more input channels, such 
that the output channel state is completely determined by the input 
channel states, except during switching transients. (3) A combinational 
logic element having at least one input channel. 


H 
hardware. The physical equipment used in data processing, as opposed 
to programs, procedures, and associated documentation. (Contrast with 


software.) 


header. An additional line at the beginning of a screen image captured 
in edit format. 


hertz (Hz). A unit of frequency equal to one cycle per second. 
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hexadecimal. Pertaining to a selection, choice, or condition that has 16 
possible values or states. These values or states usually contain 10 digits 
and 6 letters, A through F. Hexadecimal digits are equivalent to a power 
of 16. 


HOST command. The command that switches the display to host 
computer mode and activates both the file transfer and the screen capture 
sample application programs in the personal computer. 


host computer. A large, central computer that provides services such as 
computation, data base access, and special programs or programming 
languages. 
host computer mode. A mode of operation where the display is in session 
with the host application. The control unit processes your input and sends 
it to the host in this mode. The operator information area is present. 
Hz. Hertz. 

| 
IDA. Integrated display adapter. 
IML. Initial machine load. 


initial machine load (IML). The procedure that prepares the control unit 
for operation. 


initial program load (IPL). The first process in operating your personal 
computer attachment, which causes the operating system to commence 
operation. 


input/output (I/O). (1) Pertaining to a device or to a channel that may be 
involved in an input process, and, iat a different time, in an output 
process. (2) Pertaining to a device whose parts can be performing an 
input process and an output process at the same time. 

input/output area. Synonym for buffer. 

integrated display adapter (IDA). A type of control unit. 

interactive system productivity facility (ISPF). A facility that provides 


menu panels for transferring files with the IBM 3270 Personal Computer 
Attachment. 
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interface. A shared boundary. An interface might be a hardware 
component to link two devices or it might be a portion of storage or 
registers accessed by two or more computer programs. 
interrupt. (1) A suspension of a process, such as the execution of a 
computer program, in such a way that the process can be resumed. (2) To 
stop a process in such a way that it can be resumed. (3) In data 
transmission, to take an action at a receiving station that causes the 
transmitting station to terminate a transmission. 
interruptible. Synonym for enabled. 
I/O. Input/output. 
IOR. I/O Read command. 
IOW. I/O Write command. 
IPL. Initial program load. 
ISPF. Interactive system productivity facility. 

K 


k. An abbreviation for the prefix kilo, 1000 in decimal notation. 


K. When referring to storage capacity, to the tenth power, 1024 in 
decimal notation. 


keyboard reference cards. In this manual, the cards that fold out to show 
the IBM Personal Computer Keyboard functions mapped to your 3278/ 
3279 keyboard. These cards are used for reference in personal computer 
mode. 
kHz. Kilohertz. 
kilohertz (kHz). A unit of frequency equal to 1000 hertz. 

L 
logging on. The procedure by which you are linked to a multiple-user 


host computer system. The procedure requires a user identification (userid) 
and a password. 
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M 


magnetic slot reader. A device that reads precoded information from a 
magnetic stripe as it passes through a slot in the reader. 


megahertz (MHz). A unit of frequency equal to one million hertz. 
MEMR. Memory Read command. 
MEMW. Memory Write command. 


menu. A list of available operations, from which you select the operation 
you want. 


MHz. Megahertz. 


mode switch. A function that allows you to switch operating modes. You 
can switch from personal computer mode to host computer mode, or vice 
versa, by holding ALT and pressing PA1 (for text keyboards) or holding 
ALT and pressing insert (4) (all other keyboards). 


monitor. A television-type display, such as the IBM Monochrome Display. 
Monochrome Display and Parallel Printer Adapter. A high-resolution 
monochrome alphanumeric adapter with parallel printer adapter. The 
adapter provides the interface to the IBM Monochrome Display and a 
parallel interface for the IBM 80 CPS Matrix Printer. 

N 
NCP. Network control program. 
network control program. A program, generated by the user from a 
library of IBM-supplied modules, that controls the operation of a 
communication controller. 

O 
OIA. Operator information area. 
operator information area (OIA). The bottommost line of your screen 


where you receive information about the status of your personal 
computer attachment in host computer mode. 
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p 
panel. A screen full of information. 


parameter. A variable that is given a constant value for a specific 
application and that may denote the application. 


PCXFER command. The command that activates the file transfer sample 
application program in the CMS or TSO host. 


PCXFER.PROFILE data set. The data set that contains the default 
PCXFER command options for TSO file transfer. 


personal computer. A small home or business computer complete with 
a system unit and keyboard, and available with a variety of options such 
as a monochrome display and a dot matrix printer. 


personal computer file format. The format that determines how a file 
will appear in the personal computer after it is transferred from the host. 


personal computer mode. A mode of operation where the display is in 
session with the personal computer application. The personal computer 
program running in the system unit processes your input. 


personal computer printer. A desktop printer attached exclusively to 
your IBM 3270 Personal Computer Attachment. 


POST. Power-on self-test. 


power-on self-test (POST). This test is automatically performed whenever 
the system unit On/Off switch is switched to the On position. A sequence 
of responses, including a cursor, a beep, and a prompt, occur. 


problem determination. The procedures that tell you how to isolate and 
correct problems that occur during setup and operation of the IBM 3270 
Personal Computer Attachment. 


PROFILE PCXFER file. The file that contains the default PCXFER 
command options for CMS file transfer. 


program function key (PF key). A key that passes a signal to a program 


to call for a particular operation. On most 3278/3279 keyboards, the 
program function keys are located in the rightmost keypad. 
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program temporary fix (PTF). A temporary solution or bypass of a 
problem diagnosed by IBM field engineering as the result of a defect in a 
current unaltered release of the program. 

Programmed Symbol set (PSS). A collection of symbols, defined by the 
user or the application program, that are loaded into the same read/write 
storage. 

PSS. Programmed Symbol set. 

PTF. Program temporary fix. 

pushdown list. Synonym for stack. 


Q 


query reply. An inbound structured field in response to a read partition 
query structured field that defines the specific characteristics of the 
device queried. 


R 
RAM. Random access memory. 


random access memory (RAM). Storage that can be both read from and 
written to. 


record. A collection of related data or words treated as a unit; for 
example, in stock control, each invoice could constitute one record. 


register. A storage device having a specified storage capacity, such as a bit, 
a byte, or a computer word, and usually intended for a special purpose. 


request for price quotation (RPQ). A customer request for a price 
quotation on alterations or additions to the functional capabilities of a 
computing system, hardware product, device, or program product. The 
RPQ may be used to solve unique data processing problems. 


reset. (1) To cause a counter to take the state corresponding to a specified 
initial number. (2) To put all or part of a data processing device back into 


a prescribed state. (3) Contrast with set. 


RPQ. Request for price quotation. 
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Rst. Drvr. Reset Driver. 
S 
screen. The display surface. 


screen capture. A function with which you can copy the contents of the 
host screen image to the personal computer printer, diskette, or fixed disk. 


selector pen. A penlike instrument that can be attached to a display 
station to select items on the screen or generate an attention. 


self-loading diskette. A diskette that can be inserted to power up the 
system unit or used with a keyboard system reset. 


serializer. A device that converts a space distribution of simultaneous 
states representing data into a corresponding time sequence of states. 
Synonymous with dynamicizer. 


set. To cause a counter to take the state corresponding to a specified 
number. Contrast with reset. 


shift function. The set of key functions printed on the keyface at the top 
of the key and initiated by pressing Shift + the desired key. 


software. Programs, procedures, rules, and any associated documentation 
pertaining to the operation of a computer system. (Contrast with 
hardware. } 


SRA. Science Research Associates. 

stack. A list that is constructed and maintained so that the next item to 
be retrieved and removed is the most recently stored item still in the list, 
that is, last-in-first-out (LIFO). Synonymous with pushdown list. 

system diskette. This diskette is prepared by adding other files for your 
typical system and application needs to your IBM 3270 Personal Computer 
Attachment DOS diskette. 


system expansion slots. The slots that allow options to be attached to the 
IBM Personal Computer System Unit. 
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system unit. The part of your IBM 3270 Personal Computer Attachment 
that interprets between the display and the keyboard. It accomplishes all 
the processing and controlling operations for the attachment. 


T 


time sharing option (TSO). An optional configuration of the operating 
system that provides conversational time sharing from remote stations. 


.TR command. The command that specifies which characters in the 
translation table should be modified for use with PCXFER. 


trailer. An additional line at the end of a screen image captured in edit 
format. 


TSO. Time sharing option. 
U 


unformatted. A screen capture output format that copies the display 
station’s buffers for storage in machine code on a disk. 


upload program. The program that sends the file transfer sample 


application programs from the CMS or TSO data transfer diskette to the 
host. 


V 


virtual machine system product. A functional simulation of a computer 
and its associated devices. 


virtual telecommunications access method. A set of programs that control 
communication between terminals and applications running under certain 
operating systems. 


VM/SP. Virtual machine system product. 


VTAM. Virtual telecommunications access method. 
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Ww 


word. A character string or a binary element string that it is convenient 
for some purpose to consider as an entity. 


x 


XLATKBD program. A program that changes the standard mappings 
between the personal computer keyboard and the 3278/3279 keyboard. 
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adapter command register D-13 
addressing of personal computer register D-8 
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assembler application program interface 
ASCII-to-keystroke translation A-10 
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message lost A-33 
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reset 3270 attachment interrupt vector function A-14 
return codes A-29 
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set 3270 attachment input buffer address A-15 
set 3270 attachment interrupt vector function A-12 
special function values A-23 
3270 attachment interrupt handler extension interface A-30 
3278 relative key numbering A-26 
AUTOEXEC.BAT file 3-23 
adding commands 3-24 
options to 3270ATT command 3-25 
3270ATT command 3-24 
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BACKUP command J-2 

backup with file transfer 5-15 

BAS file format 
choosing 5-39 
for CMS 5-34 
for TSO 5-37 
using F-29 

BASIC application program interface B-1 
close I/O interface function B-4 
flush screen image buffer function B-12 
open I/O interface function B-3 
output data function B-13 
output keystrokes function B-6 
read screen image function B-8 
receive data flow function B-15 
receive screen image data function B-9 
set terminal mode function B-5 

BASIC compiler B-2 

BASIC interpreter B-1 

BIOS extension A-1 


C 


cable pin connections 
for 3278/3279 feature bus D-6 
for 3278/3279 keyboard D-5 
cabling the system unit to the display 2-26 
cancel message function A-21 
capturing screens (see screen capture) 
card guide 2-7 
checklist 2-3 
checkout for screen capture and data transfer 6-5 
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close G-8, G-12 
CMS (conversational monitor system) 

command failure G-22 

macro failure G-22 

requirements for upload E-5 

upload error messages E-11 

upload procedure E-10 
color/graphics monitor adapter 2-6 
COLOR option 3-25 
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COMMAND.COM file 3-23 
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console I/O error G-23 
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cover mounting screws 
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replacing 2-25 
create G-4 
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getting started 3-2 
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of application disk(s) 3-27 
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of system disk 3-24 
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data stream error G-21 
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related chapters and appendixes 5-1 
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data transfer sample application programs (see data transfer) 
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IBM 3270 Personal Computer Attachment 


Personal Computer Mode Keyboard Reference 


Cards 


This package contains 16 Personal Computer Mode Keyboard 
Reference Cards, which are described in Chapter 3 of the IBM 
3270 Personal Computer Attachment User’s Guide. You select 
the card in this package that matches your keyboard and insert 
it in the back of the user’s guide. 


To select this card: 

1. Choose, from Figures 3-1 to 3-16, the figure that matches 
your keyboard. 

2. Read the note in the figure to find which keyboard 
reference card you use. 

3. Remove the card from this package. 

4. Insert the card in the back of the JBM 3270 Personal 
Computer Attachment User’s Guide. 

5. Fold the card out against the edge of the manual for 
reference. 

6. Save the remaining keyboard reference cards for possible 


future use. 


Refer to Chapter 3 of the IBM 3270 Personal Computer 
Attachment User’s Guide for more information. 
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